前言
最近用 OpenClaw 对接飞书机器人,遇到了两个典型问题:群消息无响应和 Gateway 频繁断开。折腾了一阵子终于搞定,记录一下过程,希望能帮到同样踩坑的朋友。
遇到的问题
飞书消息不回复
在群里 @ 机器人后完全没反应。起初怀疑网络或连接状态,但显示明明在线。
Gateway 频繁断开
每次执行 openclaw gateway restart 甚至什么都不做,Gateway 都会断连。再次启动会报错,必须运行 openclaw doctor --fix 重装才能恢复,严重影响使用体验。
原因分析
飞书机器人类型不对
日志里有一行关键报错:
receive events or callbacks through persistent connection only available in self-build & Feishu app
这说明之前配置的 App ID(yyyyyyyyyyyyyy)属于快捷版或小程序类型,这类应用不支持 WebSocket 长连接收消息。换成运维提供的标准应用 ID(xxxxxxxxxxxxxxxx)后恢复正常。
多机器人配置方式错误
想给运营 agent(yunying)单独配一个飞书机器人,多次尝试都报 unknown channel id。查阅文档后发现,飞书多账号并非通过开多个渠道实现,而是需要在配置中使用 accounts 字段。
正确的 channels 配置如下:
{"channels":{"feishu":{"defaultAccount":"main","accounts":{"main":{"appId":"xxxxxxxxxxxxxxxx","appSecret":"abcdefghijklmnopqrstuvwxyz"},"yunying":{"appId":"yyyyyyyyyyyyyy"


