OpenClaw 现在接飞书,通常直接用内置的 Feishu 插件就行,而且官方文档说明它是走 WebSocket 长连接事件订阅,所以一般不需要公网 webhook,本机启动 OpenClaw Gateway 就能收消息。 

你可以按这个流程配:

1)先确认 OpenClaw 版本

较新的 OpenClaw 已经内置 Feishu 插件,不用单独安装;旧版本才需要手动装 @openclaw/feishu。 

先试:

openclaw --version

如果是较新的版本,直接进入下一步即可。

2)去飞书开放平台创建机器人应用

在飞书开放平台创建一个自建应用,然后拿到:

• App ID
• App Secret

同时至少要配置这些内容:
• 权限:im:message、im:chat、contact:user.base:readonly
• 事件订阅方式:长连接
• 订阅事件:im.message.receive_v1
• 发布应用版本

这些是社区 Feishu 插件和官方文档里都明确提到的。 

3)在 OpenClaw 里添加飞书渠道

官方文档给了两种方式,推荐直接走向导:openclaw onboard;也可以手动执行 openclaw channels add。 

最直接的是:

openclaw channels add

然后按提示:
• 选择 Feishu
• 粘贴 App ID
• 粘贴 App Secret

这一步在社区配置指南里也有完整说明。 

4)启动或重启 Gateway

openclaw gateway restart

然后查看日志:

openclaw logs --follow

如果日志里出现类似:
• feishu ws connected
• feishu provider ready

通常就表示已经连上飞书了。 

5)在飞书里测试

去飞书里搜索你刚创建的机器人,给它发一条消息,例如:

你好

如果首次回复里出现配对码,需要在本机终端执行一次授权:

openclaw pairing approve feishu <配对码>

这是一次性操作。之后就能正常聊天。 

6)最容易出问题的地方

如果你已经配了 App ID / Secret,但飞书里不能正常发消息,最常见就是下面两项漏了:

事件订阅没开
• 飞书开放平台 → 事件与回调
• 添加事件:im.message.receive_v1
• 订阅方式选择:使用长连接接收事件
这个在社区排查文档里被特别指出是最常见问题。 

Gateway 没启动
• 先执行:

openclaw gateway status

openclaw gateway restart

官方 quickstart 也要求配置完成后检查 gateway 状态。 

最小可执行命令清单

你可以直接照这个顺序跑:

openclaw channels add
openclaw gateway restart
openclaw logs --follow

然后去飞书里给机器人发消息。
如果收到配对码,再执行:

openclaw pairing approve feishu <配对码>
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐