OpenClaw 安装与飞书机器人配置实战指南

OpenClaw 通过插件支持飞书，先安装对应模块：

openclaw plugins install @openclaw/feishu
openclaw gateway restart

2. 飞书开放平台操作

登录 飞书开放平台，创建企业自建应用。

• 获取凭证：在「凭证与基础信息」页面复制 App ID 和 App Secret，务必妥善保管。
• 权限开通：进入「权限管理」批量开通以下权限：

  {"scopes":{"tenant":["im:message","im:message.group_at_msg:readonly","im:message.p2p_msg:readonly","im:message:readonly","im:message:send_as_bot","im:resource","im:chat.access_event.bot_p2p_chat:read","im:chat.members:bot_access","contact:user.employee_id:readonly"],"user":["im:chat.access_event.bot_p2p_chat:read"]}}
  

• 开启机器人能力：在「应用能力」中启用机器人并设置名称。
• 事件订阅：这是关键步骤。选择「使用长连接接收事件」（WebSocket），添加 im.message.receive_v1 事件。注意：必须确保 OpenClaw Gateway 正在运行，否则飞书无法检测到 WebSocket 连接端点。
• 发布应用：提交审核并发布，未发布前权限不生效。

3. OpenClaw 侧配置

推荐通过交互式向导添加渠道：

openclaw channels add

选择 Feishu 并按提示输入 App ID 和 App Secret。也可手动编辑配置文件 ~/.openclaw/openclaw.json：

{"channels":{"feishu":{"enabled":true,"dmPolicy":"pairing","accounts":{"main":{"appId":"cli_xxxxxxxxx","appSecret":"你的 AppSecret"}}}}}

修改后重启 Gateway：

openclaw gateway restart

4. 联调测试

1. 在飞书中向机器人发送消息（如'你好'）。
2. 机器人会返回配对码。
3. 终端执行确认：

   openclaw pairing approve feishu <配对码>
   

4. 配对成功后即可正常对话。

常见问题与排查

• 事件订阅保存失败：通常因 Gateway 未启动导致。请先运行 openclaw gateway start 确认状态后再配。
• 机器人无响应：检查应用是否已发布、事件订阅是否包含 im.message.receive_v1、是否选择了长连接模式。查看日志定位问题：

  openclaw logs --follow
  

• 群聊不回复：默认需@机器人。若需免@回复，需在配置中关闭 requireMention，并确保机器人已加入群组。
• 权限报错：飞书权限粒度较细，缺权限会导致特定功能失效。如有文档或表格操作需求，需补充 docx:document 或 bitable:app 等权限并重新发布。
• Node.js 版本过低：OpenClaw 依赖 Node.js 22+，旧版本可能导致启动异常，请通过 nvm 升级。

常用命令速查

在飞书内可使用的指令包括 /status（状态）、/reset（重置对话）、/model（切换模型）。