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

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

综述由AI生成记录了使用 OpenClaw 对接飞书群机器人时遇到的两个主要问题:一是因使用了快捷版应用 ID 导致无法接收 WebSocket 消息,需更换自建应用 ID;二是多账号配置错误及 Gateway 进程未通过 LaunchAgent 管理导致频繁断开。解决方案包括正确配置 accounts 字段绑定不同机器人,以及使用 openclaw gateway start 命令启动服务以确保自动重启。

极光发布于 2026/4/6更新于 2026/5/2224 浏览
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 管理。前台进程不受 KeepAlive 控制,断开后不会自动重启。

解决问题

飞书多账号配置

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

openclaw gateway restart 

日志确认连接成功:

feishu[yunying]: WebSocket client started feishu[main]: WebSocket client started 

Gateway 自动重启

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

# 先停掉前台运行的 Gateway
openclaw gateway stop 
# 然后用 LaunchAgent 方式启动 openclaw gateway
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
  14. 踩过的坑
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • VS Code 中 GitHub 扩展登录报错:尚未完成授权此扩展使用 GitHub 的操作
  • 腾讯云 VOD AIGC 视频生成工具回调实现
  • FPGA 实现 CAN 总线原理与 Verilog 代码详解
  • 荣耀发布 Robot Phone 与人形机器人,构建 AI 硬件生态
  • 从 try-catch 回调到链式调用:一种更优雅的 async/await 错误处理方案
  • 百考通 AIGC 检测工具功能解析与使用体验
  • llama.cpp 加载多模态 GGUF 模型方法
  • SQL Server 到 KingbaseES V9R4C12 的零改造迁移实战
  • 工业视觉缺陷检测算法总结:从传统到深度学习,5 类核心算法
  • 基于 YOLOv8 的无人机道路损伤检测系统:四类裂缝与坑洼识别
  • GitHub OAuth 登录对接配置指南
  • VSCode 连接 GitHub 的 Git 操作流程与分支管理
  • Linux TCP 协议基础与连接管理详解:从三次握手到四次挥手
  • Python+Flask+Vue 在线宠物医疗预约平台的设计与实现
  • 基于 SWIFT 的 VLLM 推理加速与部署实战
  • Vibe Coding:用 AI 自动化生成完整产品代码
  • 线性代数与 AI 的关系
  • 10 种专业渗透测试工具详解
  • 基于 FastGPT 与 MCP 协议构建工具增强型 AI Agent
  • 归并排序详解:递归实现与复杂度分析

相关免费在线工具

  • 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