当前位置：首页 > news >正文

OpenClaw对接飞书完整教程

news 2026/3/31 14:08:01

OpenClaw对接飞书完整教程

前言

OpenClaw 是一个强大的 AI 助手框架，通过与飞书的对接，我们可以在企业协作环境中快速部署智能对话机器人。本教程将详细介绍如何完成 OpenClaw 与飞书的对接配置，无需复杂的网络设置，通过 WebSocket 长连接即可实现稳定的通信。

准备工作

在开始对接之前，请确保您已经满足以下条件：

拥有飞书企业账号且具有应用创建权限
已安装 OpenClaw 主程序
网络环境通畅，能够访问飞书开放平台

第一步：创建飞书企业应用

1.1 访问飞书开放平台

打开浏览器访问飞书开放平台，使用您的企业账号登录。

1.2 创建新应用

点击 “创建企业应用”，填写应用基本信息：

应用名称：建议设置为 “OpenClaw AI 助手”
应用描述：智能 AI 助手，支持对话交互和任务执行
应用图标：可上传 OpenClaw 相关图标或使用默认图标

1.3 获取应用凭证

创建完成后，进入应用管理页面，在 “凭证与基础信息” 页面复制以下信息：

App ID：格式为cli_xxx
App Secret：请妥善保管，切勿泄露

第二步：配置应用权限和能力

2.1 添加机器人能力

在左侧导航栏选择 “应用能力”，点击 “添加能力”，选择 “机器人” 并添加。

2.2 配置权限

进入 “权限管理” 页面，批量导入以下权限：

im:message：消息读写权限
im:message:send_as_bot：以机器人身份发送消息
im:chat：群组信息访问权限

2.3 设置事件订阅

在 “事件订阅” 页面进行以下配置：

选择 “使用长连接”（WebSocket 模式）
添加事件im.message.receive_v1
确保事件状态为 “已启用”

2.4 发布应用

进入 “版本管理与发布” 页面，创建新版本并提交审批。应用必须发布并审批通过才能正常接收消息。

第三步：安装飞书插件

在终端中执行以下命令安装飞书适配插件：

openclaw pluginsinstall@openclaw/feishu

第四步：配置 OpenClaw 连接

4.1 命令行向导配置（推荐）

打开终端，执行以下命令启动配置向导：

openclaw channelsadd

按照提示完成配置：

选择feishu渠道
粘贴之前复制的 App ID 和 App Secret
选择 Endpoint type 为im
根据您的飞书版本选择环境（国内或国际版）

4.2 手动配置文件方式

如果您偏好手动编辑配置文件，可以修改~/.openclaw/openclaw.json：

{"plugins":{"entries":{"feishu":{"enabled":true}}},"channels":{"feishu":{"enabled":true,"dmPolicy":"pairing","appId":"cli_your_app_id","appSecret":"your_app_secret","domain":"feishu"}}}

4.3 环境变量配置

您也可以通过环境变量进行配置：

exportFEISHU_APP_ID="cli_your_app_id"exportFEISHU_APP_SECRET="your_app_secret"

第五步：启动服务并测试

5.1 启动 Gateway 服务

openclaw gateway restart

5.2 配对验证

在飞书中搜索您创建的应用名称
发送第一条消息，机器人会返回配对码
在终端中执行以下命令批准配对：

openclaw pairing approve feishu<配对码>

5.3 测试对话

发送测试消息，如 “你好”，如果机器人能够正常回复，说明对接成功。

高级配置选项

私聊策略配置

OpenClaw 支持四种私聊策略：

pairing（默认）：需要配对验证
allowlist：仅允许指定用户
open：任何人都可以访问
disabled：关闭私聊功能

"feishu":{"dmPolicy":"allowlist","allowFrom":["ou_user_id_1","ou_user_id_2"]}

多账号配置

支持同时运行多个飞书机器人账号：

"feishu":{"enabled":true,"accounts":{"support":{"appId":"cli_support","appSecret":"secret_support","botName":"技术支持助手"},"hr":{"appId":"cli_hr","appSecret":"secret_hr","botName":"人事助手"}}}

群组配置

群聊访问控制设置：

"feishu":{"groupPolicy":"open","groupAllowFrom":["oc_group_id_1"]}

常用管理命令

# 查看Gateway状态openclaw gateway status# 重启Gateway服务openclaw gateway restart# 查看实时日志openclaw logs--follow# 列出配对请求openclaw pairing list feishu# 批准配对openclaw pairing approve feishu<配对码># 拒绝配对openclaw pairing reject feishu<配对码>