OpenClaw 对接飞书机器人配置踩坑:消息不回与 Gateway 断开排查
OpenClaw 对接飞书机器人时出现消息无响应及 Gateway 频繁断开故障。原因包括使用了不支持 WebSocket 的快捷版应用 ID,以及前台启动 Gateway 导致无法受 LaunchAgent 管理。修复方案为更换自建应用 ID,在配置文件中通过 accounts 字段定义多账号并绑定路由,最后使用 openclaw gateway start 命令配合 LaunchAgent 确保服务自动重启。

OpenClaw 对接飞书机器人时出现消息无响应及 Gateway 频繁断开故障。原因包括使用了不支持 WebSocket 的快捷版应用 ID,以及前台启动 Gateway 导致无法受 LaunchAgent 管理。修复方案为更换自建应用 ID,在配置文件中通过 accounts 字段定义多账号并绑定路由,最后使用 openclaw gateway start 命令配合 LaunchAgent 确保服务自动重启。

使用 OpenClaw 配置飞书机器人时,遇到两个主要问题:群消息无响应、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(yunying)单独配置飞书机器人时报 "unknown channel id"。官方文档指出飞书多账号需使用 accounts 字段配置。
配置示例:
{"channels":{"feishu":{"defaultAccount":"main","accounts":{"main":{"appId":"xxxxxxxxxxxxxxxx","appSecret":"abcdefghijklmnopqrstuvwxyz"},"yunying":{"appId":"yyyyyyyyyyyyyy","appSecret":"1234567890abcdef"}}}}}
Bindings 配置:
{"bindings":[{"type":"route","agentId":"main","match":{"channel":"feishu","accountId":"main"}},{"type":"route","agentId":"yunying","match":{"channel":"feishu","accountId":"yunying"}}]}
日志显示 Gateway 收到 SIGTERM 后正常关闭,但 LaunchAgent 未自动重新加载。原因是之前在前台直接运行 openclaw gateway,不受 LaunchAgent 管理,进程断开后不会自动拉起。
修改 ~/.openclaw/openclaw.json 配置后重启 Gateway:
openclaw gateway restart
日志确认连接成功:
feishu[yunying]: WebSocket client started feishu[main]: WebSocket client started
停止前台运行的 Gateway,改用 LaunchAgent 方式启动:
# 先停掉前台运行的 Gateway
# 然后用 LaunchAgent 方式启动 openclaw gateway install openclaw gateway start
此后 Gateway 将受 LaunchAgent 管理,断开后可自动重启。
accounts 字段配置,不要尝试开多个渠道。openclaw gateway start 启动,不要直接跑 openclaw gateway。
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online