OpenClaw 对接飞书机器人配置问题排查:消息不回与 Gateway 断开
OpenClaw 对接飞书机器人时常见消息不回复及 Gateway 频繁断开问题。原因包括使用不支持 WebSocket 的快捷版应用 ID、多账号配置字段错误以及未通过 LaunchAgent 管理进程。解决方案为获取支持长连接的自建应用 ID,在配置中使用 accounts 字段区分不同机器人账户,并通过 openclaw gateway install/start 命令启动服务以确保自动重启。

OpenClaw 对接飞书机器人时常见消息不回复及 Gateway 频繁断开问题。原因包括使用不支持 WebSocket 的快捷版应用 ID、多账号配置字段错误以及未通过 LaunchAgent 管理进程。解决方案为获取支持长连接的自建应用 ID,在配置中使用 accounts 字段区分不同机器人账户,并通过 openclaw gateway install/start 命令启动服务以确保自动重启。

在飞书群里 @ 了机器人,完全没反应。状态显示连接正常,但无响应。
执行 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
openclaw gateway install
openclaw gateway start
此后 Gateway 受 LaunchAgent 管理,断开会自动重启。
accounts 字段配,别想着开多个渠道openclaw gateway start 启动,别直接跑 openclaw gateway
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online