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 加入直连/排除列表。
总结
这次问题就两句话:
- 插件版本要匹配:OpenClaw 升级后记得同步更新插件,2026.5.x 的 SDK 路径和旧版不兼容。
- 插件要在配置里注册:plugins.entries 和 plugins.allow 两者都要有飞书,光有 channels.feishu 配置不够。
遇到飞书不通的时候,先 openclaw plugins list 确认插件版本,再 grep starting feishu 看启动日志,按这个顺序排查效率最高。
环境:macOS,OpenClaw 2026.5.2,飞书插件 2026.5.2