OpenClaw 对接飞书机器人：消息无响应与 Gateway 断开排查

OpenClaw 对接飞书机器人常见问题排查

在使用 OpenClaw 集成飞书群机器人时，经常遇到两类典型故障：群内@机器人无响应，以及 Gateway 进程频繁断开且无法自动恢复。经过深入排查，核心原因通常涉及应用类型选择、多账号配置结构及守护进程管理方式。

飞书应用类型与连接限制

若发现 @机器人无反应，首先检查日志中的报错信息。常见提示为 receive events or callbacks through persistent connection only available in self-build & Feishu app。这表明当前配置的 App ID 属于快捷版或小程序类型，这类应用不支持 WebSocket 长连接接收消息。解决方案是联系运维获取自建应用的正确 App ID 并替换配置，建立持久连接后即可正常收发消息。

多机器人账号配置结构

在运营 agent 等需要多机器人接入的场景下，不能简单地开启多个渠道，而应利用 accounts 字段进行统一管理。正确的配置方式是在 channels.feishu 下定义 accounts 对象，分别填入各机器人的 appId 和 appSecret。同时，在 bindings 中通过 accountId 区分路由规则。示例如下：

{
  "channels": {
    "feishu": {
      "defaultAccount": "main",
      "accounts": {
        "main": { "appId": "xxx", "appSecret": "xxx" },
        "yunying": { "appId": "yyy", "appSecret": "yyy" }