飞书群里 @ 机器人没反应怎么办
第一步:私聊先确认状态
群聊里 @ 机器人没反应,先去私聊里测一下:
在私聊里给你的 Claw 发一条简单测试消息,比如"你好"。
如果私聊也没回复
那问题出在 Claw 本身,不是飞书群的问题——看 不回复排查,先把 Claw 本身修好了再说。
如果私聊正常回复
那问题就在飞书群的配置上,继续下面的步骤。
第二步:检查群聊状态
让 Claw 帮你查一下群聊的内部状态:
你帮我查一下这个飞书群的 groupId,并且检查群聊 session 的状态。
如果 Claw 能返回信息,说明群聊 session 是正常的。如果报错,可能是这个群没有正确关联到 Claw。
第三步:用诊断命令
在 Claw 的对话里运行飞书诊断:
/feishu start 确认飞书插件是否已安装并启动
/feishu doctor 检查飞书机器人配置是否正确
/feishu auth 批量授权飞书机器人权限
如果 /feishu start 显示插件未安装
让 Claw 重新安装飞书插件并重启:
帮我安装飞书插件并重启 OpenClaw Gateway
如果 /feishu doctor 显示配置问题
根据诊断输出的问题逐步修复,常见的有:
- 飞书应用权限不够 → 重新授权
- App ID / Secret 有误 → 重新配置
- 事件回调没设 → 在飞书开发者平台设置长连接 +
im.message.receive_v1
如果一切正常但还是不回复
检查飞书侧的群设置:
- 确认机器人被加进了这个群(不是只在个人通讯录里)
- 确认群设置里允许被 @ 时机器人回复
- 在飞书开发者平台确认应用版本已发布(不是草稿状态)
- 让 Claw 重启 OpenClaw Gateway(插件配置更新后必须重启)
快速修复清单
| 检查项 | 怎么查 |
|---|---|
| 私聊 Claw 正常吗? | 是 → 群问题;否 → Claw 本身问题 |
| 机器人在群成员里吗? | 飞书群设置 → 成员列表 |
| 飞书应用版本已发布? | 开发者平台 → 版本管理 |
| 插件已安装并启动? | /feishu start |
| App ID / Secret 正确? | /feishu doctor |
| OpenClaw Gateway 重启过? | 设置 → 重启 Kimi Claw |
事件回调 im.message.receive_v1 已添加? | 开发者平台 → 事件与回调 → 长连接 |
强制打断
如果飞书群里的 Bot 聊嗨了停不下来(比如陷入循环 @ 自己),在群聊里输入:
/stop
强制打断所有 Bot 的当前输出。
其他聊天渠道的类似问题
| 渠道 | 排查方法 |
|---|---|
| 微信 | 确认微信没有被覆盖绑定、Claw 是 2025 年 3 月 22 日后创建的 |
| 企业微信 | 确认长连接配置正确、Bot ID 和 Secret 没输错 |
| 钉钉 | 检查钉钉开发者平台的应用权限和事件订阅 |