OpenClaw 飞书报错排查：应用发布、事件订阅、权限与网关检查

先判断是哪一类故障

飞书接入问题通常可以先分成四类，这样排查更快。

• 机器人完全收不到消息：更可能是应用未发布、事件订阅不完整、长连接没开或 gateway 没跑起来。
• 群聊里不回复：更可能是 bot 没进群、默认需要 @ 提及、或者 groupPolicy 被关成了 disabled。
• 能收消息但发不出去：更可能是缺少 im:message:send_as_bot 权限，或者应用还没正式发布。
• 怀疑密钥失效或泄露：直接走 App Secret 重置流程，不要继续拿旧密钥反复测试。

飞书机器人收不到消息时先查什么

这是官方文档里最核心的一组检查项，建议按顺序一条条过。

1. 确认 Feishu / Lark 应用已经发布并通过审批，而不是还停留在草稿或待审状态。
2. 进入 Events & Callbacks，确认事件订阅里包含 im.message.receive_v1。
3. 确认使用的是长连接接收事件，而不是误以为一定要公网 webhook。
4. 回到 Permissions，确认权限批量导入已完成，不要漏掉消息读取、发送和相关 bot 能力。
5. 执行 openclaw gateway status，确认网关进程在线；继续用 openclaw logs --follow 看实时日志。

群聊里不回复通常卡在哪

官方 Feishu 文档对群聊不回复给出的排查顺序很短，但足够实用。

• 确认 bot 已经被真正加入目标群聊。
• 先按默认行为测试 @ 提及机器人，因为很多接入默认只在被 @ 时响应。
• 检查 groupPolicy 没被设成 disabled。
• 继续看 openclaw logs --follow，确认消息有没有进到 OpenClaw。

App Secret 泄露或失效怎么处理

这类问题不建议继续猜。官方文档已经给了最稳的恢复路径。

1. 在 Feishu Open Platform 或 Lark Open Platform 里重置 App Secret。
2. 把新的 App Secret 写回 OpenClaw 配置。
3. 执行 openclaw gateway restart 或重新拉起 gateway。
4. 回到私聊里做一次最小化测试，再看日志确认新凭据已生效。

消息发送失败时怎么判定

如果消息能进来但回不出去，优先怀疑发送权限和发布状态。

• 确认应用具备 im:message:send_as_bot 权限。
• 确认应用已经正式发布，而不是只在配置后台保存过。
• 直接看 openclaw logs --follow，日志通常会把发送失败的原因打出来。