前言
用 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 单独配置飞书机器人时报错'unknown channel id'。飞书多账号需在配置中使用 accounts 字段。
正确配置示例:
{"channels":{"feishu":{"defaultAccount":"main","accounts":{"main":{"appId":"xxxxxxxxxxxxxxxx","appSecret":"abcdefghijklmnopqrstuvwxyz"},"yunying":{"appId":"yyyyyyyyyyyyyy",


