OpenClaw 对接飞书机器人常见问题排查
在使用 OpenClaw 配置飞书群机器人时,经常遇到两个棘手问题:一是群里@机器人没反应,二是 Gateway 服务频繁断开。经过一番排查,定位到了根本原因并解决了问题,这里记录一下关键步骤和配置细节,供遇到同样情况的同行参考。
消息无响应的根源
在飞书群里@机器人后完全静默,状态栏却显示连接正常。翻看日志发现关键报错:
receive events or callbacks through persistent connection only available in self-build & Feishu app
这说明配置的 App ID 对应的是快捷版或小程序类型的飞书应用,这类应用不支持 WebSocket 长连接收消息。必须向运维申请正确的自建应用 ID(通常是一串长字符),替换掉原有的短 ID 后,消息接收立即恢复正常。
多账号配置陷阱
如果想给不同的运营 Agent(如 yunying)单独绑定一个飞书机器人,直接复制渠道配置往往报 "unknown channel id"。官方文档指出,飞书多账号并非通过多个渠道实现,而是需要在 channels 下定义 accounts 字段。
正确的 channels 配置如下:
{"channels":{"feishu":{"defaultAccount":"main","accounts":{"main":{"appId":"xxxxxxxxxxxxxxxx","appSecret":"abcdefghijklmnopqrstuvwxyz"},"yunying":{"appId":"yyyyyyyyyyyyyy","appSecret":"1234567890abcdef"}


