前言
使用 OpenClaw 配置飞书机器人时,遇到群消息无响应及 Gateway 频繁断开的问题。经过排查定位原因并修复,记录如下供参考。
发现问题
飞书消息不回复
在飞书群里 @ 机器人后完全无反应。状态显示连接正常,但无法接收事件。
Gateway 频繁断开
执行 openclaw gateway restart 或空闲状态下,Gateway 均可能断开。再次启动报错,需运行 openclaw doctor --fix 重新安装才能恢复。
查看原因
飞书机器人 ID 类型错误
日志提示:
receive events or callbacks through persistent connection only available in self-build & Feishu app
原配置使用的是快捷版/小程序类型的 App ID,不支持 WebSocket 长连接收消息。更换为正确的自建应用 ID 后恢复正常。
多机器人配置结构错误
尝试为运营 agent(yunying)单独配置飞书机器人时报 "unknown channel id"。飞书多账号需通过 accounts 字段配置,而非多个渠道。
正确 channels 配置示例:
{"channels":{"feishu":{"defaultAccount":"main","accounts":{"main":{"appId":"xxxxxxxxxxxxxxxx","appSecret":"abcdefghijklmnopqrstuvwxyz"},"yunying":{"appId":"yyyyyyyyyyyyyy","appSecret"


