openClaw怎么配置飞书

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

你可以按这个流程配：

1）先确认 OpenClaw 版本

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

先试：

bash 复制代码

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。

最直接的是：

bash 复制代码

openclaw channels add

然后按提示：

• 选择 Feishu

• 粘贴 App ID

• 粘贴 App Secret

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

⸻

4）启动或重启 Gateway

bash 复制代码

openclaw gateway restart

然后查看日志：

bash 复制代码

openclaw logs --follow

如果日志里出现类似：

• feishu ws connected

• feishu provider ready

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

⸻

5）在飞书里测试

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

你好

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

bash 复制代码

openclaw pairing approve feishu <配对码>

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

⸻

6）最容易出问题的地方

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

事件订阅没开

• 飞书开放平台 → 事件与回调

• 添加事件：im.message.receive_v1

• 订阅方式选择：使用长连接接收事件

这个在社区排查文档里被特别指出是最常见问题。

Gateway 没启动

• 先执行：

bash 复制代码

openclaw gateway status

或

bash 复制代码

openclaw gateway restart

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

⸻

最小可执行命令清单

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

bash 复制代码

openclaw channels add
openclaw gateway restart
openclaw logs --follow

然后去飞书里给机器人发消息。

如果收到配对码，再执行：

bash 复制代码

openclaw pairing approve feishu <配对码>