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" }


