OpenClaw 飞书机器人从 0 到 1 配置指南

必须开通的权限：

建议额外开通（用于后续高级功能）：

提示： 权限开通后需要发布新版本才生效（第七步操作）。

第六步：配置事件订阅（接收用户消息的关键）

左侧菜单 → 事件与回调 → 事件订阅

选择订阅方式：

选'长连接' → 点击'添加事件' → 搜索'接收消息' → 勾选 im.message.receive_v1。

保存。

第七步：将凭证填入 OpenClaw

回到服务器（或本地终端），执行：

openclaw channels add feishu

按提示依次输入：

App ID：cli_xxxxxxxxxx（第三步复制的）
App Secret：xxxxxxxxxxxxxxxx（第三步复制的）

看到'飞书渠道配置成功'提示后，执行：

openclaw status

确认飞书渠道状态显示为 connected。

第八步：发布应用版本

这步容易被忽略，不发布版本机器人不会出现在飞书里。

回到飞书开发者后台 → 左侧菜单 → 版本管理与发布

点击'创建版本' → 填写版本号（如 1.0.0）和发布说明 → 申请发布

• 企业自建应用：需要企业管理员在飞书管理后台审批
• 个人应用：通常直接审批通过

审批通过后，应用正式上线。

第九步：验证全流程

1. 打开飞书
2. 顶部搜索框搜索你的机器人名称（应用名称）
3. 点开与机器人的对话
4. 发送'你好'

成功标志： 收到 AI 回复，内容合理有意义。

常见问题排查

进阶配置：让机器人在群里也能用

默认配置只支持和机器人私聊。要让机器人加入群聊并响应消息：

1. 权限管理里开通 im:chat
2. 事件订阅里额外添加 im.message.receive_v1（群消息事件，同一个事件，已订阅则跳过）
3. 在飞书群里 → 群设置 → 群机器人 → 添加机器人 → 找到你的机器人
4. 在群里发消息时，@机器人名字触发回复

注意事项

配置步骤较多，最容易卡住的地方是两个：权限没开够和版本没发布。这两个问题加起来占了 90% 的'为什么机器人没反应'。

配置好之后的体验非常流畅——私聊、群聊都能用，飞书的消息格式支持也比微信好得多（可以发代码块、表格、链接）。