openClaw怎么配置飞书
OpenClaw飞书接入实战：从配置到联调的关键流程
把OpenClaw对接到飞书，这事儿现在其实挺顺畅的。得益于官方内置的Feishu插件，整套流程已经相当标准化。核心就在于，它是通过WebSocket长连接来订阅消息事件的，这意味着你一般不需要折腾公网Webhook，本地启动OpenClaw Gateway服务就能顺利接收消息。
下面就是一套经过验证的配置流程，照着做就行。
第一步：确认你的OpenClaw版本
这是个好习惯。较新版本的OpenClaw通常已经内置了Feishu插件，无需额外安装；而旧一些的版本可能需要手动安装@openclaw/feishu。怎么确认呢？很简单：
openclaw --version如果显示的是较新的版本号，直接进入下一步操作即可。
第二步：飞书开放平台的准备工作
这里需要去飞书开放平台创建一个“自建应用”，也就是你的机器人。创建完成后，务必拿到两把关键“钥匙”：
- App ID
- App Secret
光是拿到密钥还不够，应用配置里有几项必须设置妥当：
- 权限管理：至少需要添加
im:message、im:chat、contact:user.base:readonly这几项。 - 事件订阅方式：选择“长连接”。
- 订阅事件：务必添加
im.message.receive_v1。 - 发布应用：完成配置后，记得在开发者后台提交并发布一个应用版本。
这些步骤在官方和社区的文档里都是反复强调的要点。
第三步：在OpenClaw中添加飞书渠道
现在回到OpenClaw环境。官方推荐使用引导命令 openclaw onboard，当然，直接手动添加渠道也很直观：
openclaw channels add执行后，跟随命令行提示操作：
- 选择“Feishu”作为渠道类型。
- 粘贴上一步获取的 App ID。
- 粘贴对应的 App Secret。
完成这一步，OpenClaw就记住了你的飞书机器人身份。
第四步：启动并检查Gateway服务
添加渠道后，需要重启Gateway服务来使配置生效：
openclaw gateway restart重启完，怎么知道连没连上呢？查看实时日志是最直接的方法：
openclaw logs --follow如果一切正常，你应该能在日志中看到类似 feishu ws connected 或 feishu provider ready 这样的成功连接信息。这就意味着到飞书的链路通了。
第五步：在飞书里进行测试
现在，可以打开飞书，搜索你刚刚创建的机器人应用，给它发条消息试试，比如简单的“你好”。
这里有个常见情况：如果是首次对话，机器人可能会回复一个“配对码”。别担心，这是正常的一次性授权流程。你只需要在本机终端执行一下授权命令：
openclaw pairing approve feishu <配对码>授权完成后，后续的对话就会畅通无阻了。
第六步：故障排查：最容易踩坑的两个地方
配置流程本身不复杂，但实操中，绝大多数问题都出在下面两个环节：
1. 事件订阅没开启或选错方式
这堪称“头号杀手”。请务必再次前往飞书开放平台的应用后台，检查：
- **事件与回调**页面里，是否已添加事件：im.message.receive_v1。
- **订阅方式**是否明确选择了“使用长连接接收事件”。
社区里大量的反馈都指向了这个配置疏漏。
2. Gateway服务状态异常
有时候，可能只是服务没跑起来。可以通过以下命令快速检查：
openclaw gateway status如果状态不对，重启一下：
openclaw gateway restart官方快速开始指南也同样强调了配置后检查Gateway状态的重要性。
最小可行命令清单
如果你想要一个最简洁、直奔主题的操作序列，下面这个清单可以帮你快速完成配置和验证：
# 添加渠道并配置密钥
openclaw channels add
# 重启网关服务使配置生效
openclaw gateway restart
# 查看实时日志，确认连接状态
openclaw logs --follow执行上述命令后，直接去飞书给机器人发消息。若遇到配对码，再执行：
openclaw pairing approve feishu <配对码>至此，整个接入流程就闭环了。