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

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

OpenClaw 对接飞书机器人时出现消息无响应和 Gateway 断开问题。原因包括飞书应用类型不支持 WebSocket 长连接、多账号配置字段错误以及 Gateway 前台运行导致无法被 LaunchAgent 自动重启。解决方案是更换正确的自建应用 ID,在配置文件中通过 accounts 字段配置多账号,并使用 openclaw gateway start 命令配合 LaunchAgent 启动服务以确保自动恢复。

DataScient发布于 2026/4/9更新于 2026/10/1581 浏览
OpenClaw 对接飞书机器人配置踩坑:消息无响应与 Gateway 断开排查

问题描述

在 OpenClaw 配置飞书机器人时,遇到群消息无响应及 Gateway 频繁断开的问题。

飞书消息不回复

@机器人后无反应,状态显示连接正常。

Gateway 频繁断开

执行 openclaw gateway restart 或空闲时 Gateway 断开,启动报错,需运行 openclaw doctor --fix 修复。

原因分析

飞书应用类型错误

日志提示仅自建应用支持 WebSocket 长连接收消息。初始配置的 App ID 为快捷版/小程序类型,不支持该功能。需使用正确的自建应用 ID。

多机器人配置方式错误

运营 Agent 单独配置飞书机器人时报错 unknown channel id。飞书多账号需通过 accounts 字段配置,而非多个渠道。

Gateway 进程管理问题

日志显示 Gateway 收到 SIGTERM 后正常关闭,但 LaunchAgent 未自动重新加载。前台直接运行 openclaw gateway 不受 LaunchAgent 的 KeepAlive 控制,断开后无法自动重启。

解决方案

飞书多账号配置

修改 ~/.openclaw/openclaw.json 配置文件,使用 accounts 字段定义多个账号,并在 bindings 中指定 accountId。

配置示例:

{"channels":{"feishu":{"defaultAccount":"main","accounts":{"main":{"appId":"xxxxxxxxxxxxxxxx","appSecret":"abcdefghijklmnopqrstuvwxyz"},"yunying":{"appId":"yyyyyyyyyyyyyy","appSecret":"1234567890abcdef"}}}}}

绑定示例:

{"bindings":[{"type":"route","agentId":"main","match":{"channel":"feishu","accountId":"main"}},{"type":"route","agentId":"yunying","match":{"channel":"feishu","accountId":"yunying"}}]}

重启 Gateway 验证:

openclaw gateway restart

日志显示两个 WebSocket 客户端均已启动。

Gateway 自动重启

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

# 停止前台运行的 Gateway
openclaw gateway install
openclaw gateway start

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

注意事项

  1. 飞书多账号需使用 accounts 字段配置。
  2. Gateway 必须使用 openclaw gateway start 命令启动,以便由 LaunchAgent 接管。

目录

  1. 问题描述
  2. 飞书消息不回复
  3. Gateway 频繁断开
  4. 原因分析
  5. 飞书应用类型错误
  6. 多机器人配置方式错误
  7. Gateway 进程管理问题
  8. 解决方案
  9. 飞书多账号配置
  10. Gateway 自动重启
  11. 停止前台运行的 Gateway
  12. 注意事项

更多推荐文章

查看全部
  • ChatGPT 保护指令:提升 GPTs 提示词与知识库文件安全性
  • SpringAI Agent 开发实战:基于 Skills 实现代码评审
  • Arduino BLDC 机器人 IMU 角度读取、PID 控制与互补滤波
  • 网络安全行业岗位缺口分析:基于美国市场数据的观察
  • GPEN 批量处理断点续传功能设计与实现
  • 用 MCP 给 Claude 接上天气预报
  • OpenWebUI 本地部署与 cpolar 内网穿透实战指南
  • 数据结构空间复杂度详解:概念与常见计算示例
  • Linux Crontab 定时任务配置、用法与实战案例
  • GitHub 启用双因素身份验证(2FA)配置指南:TOTP.app 动态验证码设置
  • AI 大模型 40 年发展历程与未来统一趋势研究
  • Stable Diffusion 模型原理与本地部署实践
  • 使用 Java 实现简单高效的任务调度框架
  • Web 自动化测试入门指南:从概念到 Selenium 实战
  • 2024 年边缘人工智能现状与大模型开发技术指南
  • 朴素贝叶斯算法详解
  • Vue3 前端开发常用 20 道面试题及代码解析
  • DooTask:AI 赋能的开源项目协作工具部署与使用指南
  • 前端 Vue 项目打包及部署详解
  • RCTF 2025 Web 部分解题思路与漏洞分析

相关免费在线工具

  • 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