背景
使用 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 属于快捷版或小程序类型,不支持 WebSocket 长连接。需向运维申请支持自建应用的正确 ID。
多账号配置错误
尝试为运营 Agent 单独配置机器人时,一直报 "unknown channel id"。查阅文档发现,飞书多账号并非通过开启多个渠道实现,而应在 channels 下使用 accounts 字段定义。
守护进程管理缺失
Gateway 收到 SIGTERM 信号后正常退出,但系统未自动拉起新进程。原因是之前采用前台模式直接运行 openclaw gateway,绕过了 LaunchAgent 的管理机制,导致进程退出后无法自恢复。
解决方案
修正多账号配置
更新 ~/.openclaw/openclaw.json,确保 accounts 结构正确:
{
"channels": {
"feishu": {
"defaultAccount": "main",
"accounts": {
"main": {"appId": "xxxxxxxxxxxxxxxx", "appSecret": "abcdefghijklmnopqrstuvwxyz"


