OpenClaw 飞书插件「假在线」排查实录

2026-05-03 45 0

飞书机器人彻底「哑了」,群里发消息完全没人理。日志满屏都是:

ws unable to connect to the server after trying 32 times

还有一些网络错误:

ECONNABORTED timeout of 30000ms exceeded
ECONNREFUSED connection refused
EHOSTUNREACH 198.18.0.105:443

奇怪的是,直接 curl 飞书 API 完全正常,能拿到 token。说明网络没问题,是 OpenClaw 自己的问题。

排查过程

第一步:确认插件有没有加载

openclaw plugins list

飞书插件显示 enabled,但日志里完全没有飞书相关的启动信息。微信插件正常输出了 [runtime] setWeixinRuntime called,飞书这边静悄悄的,说明根本没启动。

第二步:检查插件版本是否匹配

cat ~/.openclaw/extensions/feishu/package.json | grep version

插件版本是 2026.3.13,OpenClaw 本身是 2026.5.2。旧版插件引用了一个在新版 SDK 里已经不存在的路径,加载直接失败:

Error: Cannot find module ...root-alias.cjs/feishu

第三步:检查插件有没有在配置里注册

再看 plugins.entries,根本沒有 feishu。配置了 channels.feishu 但没在插件里注册,OpenClaw 当然不知道要加载它。

修复步骤

第一步:卸载旧插件

printf y\\n | openclaw plugins uninstall feishu

第二步:安装新版插件

npm install -g @openclaw/feishu@latest

第三步:手动复制到 extensions 目录

cp -r /opt/homebrew/lib/node_modules/@openclaw/feishu/* ~/.openclaw/extensions/feishu/

第四步:在配置里显式注册

编辑 ~/.openclaw/openclaw.json,在 plugins.entries 里添加:

"plugins": {
  "entries": {
    "feishu": { "enabled": true }
  },
  "allow": ["feishu"]
}

第五步:重启 Gateway

openclaw gateway restart

验证

grep starting feishu /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log

正常输出:

starting feishu[default] (mode: websocket)
starting feishu[main-agent] (mode: websocket)
starting feishu[mumu] (mode: websocket)
starting feishu[cc] (mode: websocket)

附加问题:群里别人看不到回复

在配置文件顶层加一行:

"messages": {
  "groupChat": {
    "visibleReplies": "automatic"
  }
}

关于代理:ClashX Pro 的坑

日志里 EHOSTUNREACH 198.18.0.105:443 这个 IP 段 198.18.x.x 是 ClashX Pro 代理 TUN 模式的特征。建议在代理软件里把 open.feishu.cn 加入直连/排除列表。

总结

这次问题就两句话:

  1. 插件版本要匹配:OpenClaw 升级后记得同步更新插件,2026.5.x 的 SDK 路径和旧版不兼容。
  2. 插件要在配置里注册:plugins.entries 和 plugins.allow 两者都要有飞书,光有 channels.feishu 配置不够。

遇到飞书不通的时候,先 openclaw plugins list 确认插件版本,再 grep starting feishu 看启动日志,按这个顺序排查效率最高。


环境:macOS,OpenClaw 2026.5.2,飞书插件 2026.5.2

相关文章

Claude Code源码泄漏:51万行代码公开
Google Stitch重塑AI设计规则:从出图工具到智能工作台
Midjourney V8 Alpha发布:生成速度提升4-5倍
Black Forest Labs发布FLUX.2:重塑图像生成行业
【AI 短讯】小米开源推理大模型 Xiaomi MiMo
【AI 短讯】开源AI上色模型 Cobra 发布!