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

OpenClaw 对接飞书机器人配置踩坑:消息不回与 Gateway 断开排查

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

莫名其妙发布于 2026/3/26更新于 2026/10/2681 浏览
OpenClaw 对接飞书机器人配置踩坑:消息不回与 Gateway 断开排查

前言

使用 OpenClaw 配置飞书机器人时,遇到两个主要问题:群消息无响应、Gateway 频繁断开。经过排查已解决,记录如下供参考。

发现问题

飞书消息不回复

在飞书群里 @ 机器人后无反应。状态显示连接正常,但实际未收到回调。

Gateway 频繁断开

执行 openclaw gateway restart 或空闲状态下,Gateway 均会断开。再次启动报错,需运行 openclaw doctor --fix 重新安装才能恢复。

查看原因

飞书机器人 ID 错误

日志提示:

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 断开原因

日志显示 Gateway 收到 SIGTERM 后正常关闭,但 LaunchAgent 未自动重新加载。原因是之前在前台直接运行 openclaw gateway,不受 LaunchAgent 管理,进程断开后不会自动拉起。

解决问题

飞书多账号配置

修改 ~/.openclaw/openclaw.json 配置后重启 Gateway:

openclaw gateway restart

日志确认连接成功:

feishu[yunying]: WebSocket client started feishu[main]: WebSocket client started
Gateway 自动重启

停止前台运行的 Gateway,改用 LaunchAgent 方式启动:

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

此后 Gateway 将受 LaunchAgent 管理,断开后可自动重启。

踩过的坑

  1. 飞书多账号要用 accounts 字段配置,不要尝试开多个渠道。
  2. Gateway 一定要用 openclaw gateway start 启动,不要直接跑 openclaw gateway。

目录

  1. 前言
  2. 发现问题
  3. 飞书消息不回复
  4. Gateway 频繁断开
  5. 查看原因
  6. 飞书机器人 ID 错误
  7. 多机器人配置失败
  8. Gateway 断开原因
  9. 解决问题
  10. 飞书多账号配置
  11. Gateway 自动重启
  12. 先停掉前台运行的 Gateway
  13. 然后用 LaunchAgent 方式启动 openclaw gateway install openclaw gateway start
  14. 踩过的坑

更多推荐文章

查看全部
  • 基于 DeepSeek 和 Cursor 构建智能代码审查工具实战
  • 大模型应用中的 Prompt 提示词管理与优化实践
  • Docker 部署 AI 量化分析平台:环境配置与波浪理论实战
  • 用 Java 设计一个随机验证码生成器
  • C++ 红黑树设计与实现详解
  • Android 开发中 OOM 问题的常见原因与解决方案
  • C++ 栈与队列的使用与模拟实现
  • Windows、macOS 与 Linux 系统下多种 Python 环境安装指南
  • Java 基于百度 API 实现海外城市实时天气获取
  • Android 逆向:在 Unidbg 中解决 native 函数内调用 Java 方法的报错
  • Markdown 笔记图片自动上传方案:Gitee+PicGo 搭建实战
  • Java ResourceBundle 与 .NET RESX 国际化方案对比
  • Day.js 轻量级日期处理核心用法
  • OpenClaw 从零到一安装部署与 QQ 机器人接入指南
  • GitHub Copilot SDK 与云原生多智能体系统实践
  • Ubuntu Linux 操作系统安装与配置指南
  • AMD显卡运行llama.cpp的兼容性与部署方案
  • IntelliJ IDEA 中 Java AI 插件安装与实战指南
  • LW-CTrans: 一种用于 3D 医学图像分割的轻量级 CNN 与 Transformer 混合网络
  • C++ 随机生成 RxC 列联表及源码实现

相关免费在线工具

  • RSA密钥对生成器

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

  • Mermaid 预览与可视化编辑

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

  • 随机西班牙地址生成器

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

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

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

  • Base64 文件转换器

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