OpenClaw 飞书接入指南：先跑消息闭环，再补初始化和技能

飞书接入最值的不是"配很多"，而是"先收敛"

第一次飞书接入最常见的失败原因不是配不对，而是同时在做太多事：

• 飞书应用创建
• OpenClaw 初始化
• 技能安装
• 自动化工作流

任何一步出错，你都不知道问题在哪。更稳的方式是一步一步来。

第一步：安装飞书官方插件

OpenClaw 有飞书官方插件 @openclaw/feishu，支持消息、文档、多维表格、日历和任务：

openclaw plugins install @openclaw/feishu

第二步：在飞书开放平台创建应用

1. 打开 飞书开放平台
2. 创建一个企业自建应用
3. 记录 App ID 和 App Secret

第三步：通过向导配置渠道

openclaw channels add

选择飞书渠道，按提示填入 App ID 和 App Secret。

也可以手动配置 JSON：

{
  "channel": "feishu",
  "appId": "cli_xxxx",
  "appSecret": "xxxx",
  "encryptKey": "xxxx",
  "verificationToken": "xxxx"
}

第四步：配置飞书应用权限

在飞书开放平台的应用管理页面，至少开启这些权限：

• im:message — 收发消息
• im:message.group_at_msg — 群聊 @ 消息
• im:resource — 消息中的文件和图片

如果需要文档和多维表格能力，再加：

• docs:doc — 云文档读写
• sheets:spreadsheet — 多维表格读写
• calendar:calendar — 日历读写

第五步：配置事件订阅

在飞书开放平台配置「事件订阅」：

• 添加 im.message.receive_v1 事件
• 选择 WebSocket 方式（不需要公网回调地址）

配置完成后检查 Gateway 状态：

openclaw gateway status

第六步：发布版本

在飞书开放平台点击「创建版本」并发布。不发布，前面很多配置都等于没生效。

第七步：验证最小消息闭环

在飞书群里 @ 你的机器人，发一条最简单的消息：

@你的机器人 你好

预期结果：机器人在几秒内回复。

如果没回复，按这个顺序排查：

openclaw gateway status
openclaw logs --follow
openclaw doctor

常见坑

权限没发布

改了权限但没重新发布版本，权限不会生效。

事件订阅没配

应用能看到但消息不触发，大概率是事件订阅没加 im.message.receive_v1。

机器人不在群里

确认机器人已经被添加到目标群聊。

Gateway 没启动

openclaw gateway status 如果不是 running 状态，先重启：

openclaw gateway restart

验证成功后再做什么

消息闭环跑通之后，再按顺序补：

1. 运行 openclaw onboard --install-daemon 完成初始化
2. 安装第一批技能：openclaw skills install @clawhub/web-search
3. 写 AGENTS.md 定义机器人行为规则
4. 做一次安全审计：openclaw security audit --deep

继续阅读

• 飞书接入详细配置
• 飞书初始化配置指南
• 飞书开放平台
• 官方文档 → docs.openclaw.ai
• 遇到问题 → GitHub Issues