跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashSaaSAI

OpenClaw 对接飞书机器人:消息无响应与 Gateway 断开排查

OpenClaw 对接飞书机器人时遇到消息无响应及 Gateway 频繁断开问题。经排查,消息不回源于使用了不支持 WebSocket 的快捷版应用 ID;多账号配置需通过 accounts 字段而非多渠道实现;Gateway 断开则因前台启动未受 LaunchAgent 管理。解决方案包括更换正确应用 ID、修正配置文件结构以及使用 openclaw gateway start 命令交由系统守护进程管理。

星河入梦发布于 2026/4/5更新于 2026/9/763 浏览
OpenClaw 对接飞书机器人:消息无响应与 Gateway 断开排查

前言

最近用 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","appSecret":"1234567890abcdef"}}}}}

bindings 部分对应绑定:

{"bindings":[{"type":"route","agentId":"main","match":{"channel":"feishu","accountId":"main"}},{"type":"route","agentId":"yunying","match":{"channel":"feishu","accountId":"yunying"}}]}
Gateway 断开根源

日志显示 Gateway 收到 SIGTERM 后正常关闭,但 LaunchAgent 没有自动重载。原因是之前一直用 openclaw gateway 在前台启动,这绕过了 LaunchAgent 的管理。虽然 LaunchAgent 配置了 KeepAlive: true,但前台进程不受其控制,断开后就无法自动拉起。

解决方案

修复多账号配置

更新 ~/.openclaw/openclaw.json 后重启 Gateway:

openclaw gateway restart 

日志确认两个机器人均已连接:

feishu[yunying]: WebSocket client started feishu[main]: WebSocket client started 
启用自动守护

停止前台运行的 Gateway,改用 LaunchAgent 管理:

# 先停掉前台运行的 Gateway
openclaw gateway stop
# 使用 LaunchAgent 方式启动
openclaw gateway install
openclaw gateway start 

此后 Gateway 将受系统守护进程管理,异常断开会自动重启,无需手动干预。

经验总结

  1. 飞书多账号务必使用 accounts 字段配置,不要试图开启多个渠道。
  2. Gateway 启动请使用 openclaw gateway start,确保由 LaunchAgent 接管。

目录

  1. 前言
  2. 遇到的问题
  3. 飞书消息不回复
  4. Gateway 频繁断开
  5. 原因分析
  6. 飞书机器人类型不对
  7. 多机器人配置方式错误
  8. Gateway 断开根源
  9. 解决方案
  10. 修复多账号配置
  11. 启用自动守护
  12. 先停掉前台运行的 Gateway
  13. 使用 LaunchAgent 方式启动
  14. 经验总结

更多推荐文章

查看全部
  • C++ 图论最短路径算法详解
  • Python 打造 AI 三剑客:文档总结、代码生成与智能检索
  • 企业大模型微调项目落地的关键岗位角色与职责
  • Stable Diffusion XL 与 Z-Image-Turbo 画质对比:实测部署案例
  • Web 自动化测试实战:基于 Python+Selenium 的博客系统测试流程
  • C/C++ 全局变量跨文件访问机制:链接属性与原理
  • IntelliJ IDEA GitLab 登录失败:检查 API Token 或版本兼容性
  • C++ STL list 模拟实现:从底层链表到容器封装
  • OpenClaw 在 Linux 上接入本地 Ollama 的配置记录
  • GitHub Copilot 提示词工程指南:掌握 AI 编程协作核心技巧
  • OpenClaw 中 web_search 与 web_fetch 最佳实践速查
  • Trae AI 安装与使用指南
  • SpringAI 基于 Ollama 本地部署 Deepseek 模型实现对话机器人
  • OpenClaw 爆火背后的 AI Agent 破圈真相
  • 大模型时代:为何传统机器学习仍是 AI 入门最佳路径
  • AI 开发安全与治理:成为主人而非被绑架
  • JavaScript reduce 方法详解与实战
  • TRAE Skills 全解析:从概念到实践
  • VLA 机器人革命:解析 10 篇关键视觉 - 语言 - 动作模型论文
  • 腾讯云轻量应用服务器部署 OpenClaw 并接入 QQ 飞书机器人

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online