大多数问题不是插件没装
当前 OpenClaw 版本通常已经自带 Feishu 插件。真正更常见的是应用没发布、权限没导入完整、事件订阅漏配，或者 gateway 没启动。
OpenClaw 教程飞书排错Feishu / Lark
OpenClaw 飞书报错排查：应用发布、事件订阅、权限与网关检查
这页面向搜索“OpenClaw 飞书报错排查”“OpenClaw 飞书机器人不回消息”“OpenClaw Feishu 事件订阅”的用户，重点不是重复安装步骤，而是把最常见的故障拆成可执行的检查顺序。
OpenClaw 官方 Feishu 文档已经把排错路径写得很清楚：如果机器人没反应，先查应用是否发布、事件订阅里是否包含 im.message.receive_v1、长连接是否开启、权限是否完整，以及 gateway 是否真的在运行。
先查发布状态im.message.receive_v1App Secret 重置
先分清“收不到”还是“发不出”
如果是收不到消息，优先查发布、事件订阅和长连接；如果是发不出消息，优先查 im:message:send_as_bot 权限、发布状态和日志。
App Secret 泄露要直接旋转
官方文档给出的处理非常直接：在 Feishu Open Platform 重置 App Secret，回到 OpenClaw 配置里更新，然后重启 gateway。
先判断是哪一类故障
飞书接入问题通常可以先分成四类，这样排查更快。
- 机器人完全收不到消息：更可能是应用未发布、事件订阅不完整、长连接没开或 gateway 没跑起来。
- 群聊里不回复：更可能是 bot 没进群、默认需要 @ 提及、或者 groupPolicy 被关成了
disabled。 - 能收消息但发不出去：更可能是缺少
im:message:send_as_bot权限，或者应用还没正式发布。 - 怀疑密钥失效或泄露：直接走 App Secret 重置流程，不要继续拿旧密钥反复测试。
飞书机器人收不到消息时先查什么
这是官方文档里最核心的一组检查项，建议按顺序一条条过。
- 确认 Feishu / Lark 应用已经发布并通过审批，而不是还停留在草稿或待审状态。
- 进入 Events & Callbacks，确认事件订阅里包含
im.message.receive_v1。 - 确认使用的是长连接接收事件，而不是误以为一定要公网 webhook。
- 回到 Permissions，确认权限批量导入已完成，不要漏掉消息读取、发送和相关 bot 能力。
- 执行
openclaw gateway status，确认网关进程在线；继续用openclaw logs --follow看实时日志。
如果你还没跑通基础安装，先回到 Windows 安装页或飞书接入页，不要把安装问题和消息链路问题混在一起。
群聊里不回复通常卡在哪
官方 Feishu 文档对群聊不回复给出的排查顺序很短，但足够实用。
- 确认 bot 已经被真正加入目标群聊。
- 先按默认行为测试 @ 提及机器人，因为很多接入默认只在被 @ 时响应。
- 检查
groupPolicy没被设成disabled。 - 继续看
openclaw logs --follow，确认消息有没有进到 OpenClaw。
App Secret 泄露或失效怎么处理
这类问题不建议继续猜。官方文档已经给了最稳的恢复路径。
- 在 Feishu Open Platform 或 Lark Open Platform 里重置 App Secret。
- 把新的 App Secret 写回 OpenClaw 配置。
- 执行
openclaw gateway restart或重新拉起 gateway。 - 回到私聊里做一次最小化测试，再看日志确认新凭据已生效。
消息发送失败时怎么判定
如果消息能进来但回不出去，优先怀疑发送权限和发布状态。
- 确认应用具备
im:message:send_as_bot权限。 - 确认应用已经正式发布，而不是只在配置后台保存过。
- 直接看
openclaw logs --follow，日志通常会把发送失败的原因打出来。