升级OpenClaw后飞书Bot不回消息了

📝 文章简介

一次正常的OpenClaw升级，飞书Bot突然不回消息了。排查过程：Gateway正常 → API凭证正常 → 日志超时 → 最终发现飞书插件从内置变成了外部插件。顺便还把Dashboard模型列表从22个精简到16个。

🏷️ 文章标签#OpenClaw#踩坑指南#飞书#模型配置

升级OpenClaw后飞书Bot不回消息了

一、起因：Dashboard里的模型太多了

事情是这样的。我打开OpenClaw的Dashboard一看，模型列表密密麻麻，22个模型7个Provider，看着都眼花。

仔细一看，问题不少：

glm

和 bigmodel 指向同一个服务（智谱），只是API Key不同
qwen

和 bailian 共用同一API Key，模型有重叠
codex

是ChatGPT代理，基本不用
部分 deepseek 配置的API Key是占位符（”请填写”）

所以决定精简一下：只保留4个Provider，删掉重复和不用的。

二、顺便把OpenClaw也升级了

正好看到有新版本 v2026.5.7，想着一起升了吧。

升级步骤很简单：

cd D:\openclawnpm update openclaw

验证一下：

node D:\openclaw\node_modules\openclaw\dist\index.js --version# 输出：OpenClaw 2026.5.7 (eeef486)

升级成功。然后重启了Gateway。

三、问题来了：飞书Bot不回复了

升级完Dashboard能正常访问，Gateway也正常启动。但是飞书机器人不回复任何消息了。

我开始排查：

排查1：Gateway健康状态

curl http://127.0.0.1:18789/health→ {"ok":true,"status":"live"}

正常。

排查2：飞书API凭证

curl https://open.feishu.cn/open-apis/auth/v3/app_access_token/internal→ {"code":0,"msg":"ok","tenant_access_token":"..."}

凭证正常，token能正常获取。

排查3：Gateway日志

在日志里发现了关键线索：

feishu[main]: bot info probe timed out after 30000msAxiosError: timeout of 30000ms exceeded

飞书API超时了。但奇怪的是，我用curl手动测试同一个API是正常的。问题不在网络，也不在凭证。

排查4：插件加载情况

对比新旧版本的启动日志，发现了关键差异：

旧版本：6 plugins: acpx, browser, device-pair, feishu, phone-control, talk-voice新版本：6 plugins: browser, device-pair, file-transfer, memory-core, phone-control, talk-voice

新版本的插件列表里没有 feishu！

排查5：插件目录

去新版本目录一看，果然：

D:\openclaw\node_modules\openclaw\dist\extensions\→ 没有 feishu 目录

破案了。

四、根本原因

⚠️ Breaking Changev2026.5.7 将飞书通道从内置插件拆分为独立npm包 @openclaw/feishu。旧版本中飞书是内置在 dist/extensions/feishu/ 目录中的。新版本中该目录已移除，飞书被移到了插件市场（marketplace），作为外部插件单独发布。

这意味着：升级core包之后，飞书插件不会自动安装，需要手动装。

五、修复步骤

修复其实很简单，就三步：

步骤1：停止旧Gateway进程

cd D:\openclawnode node_modules\openclaw\dist\index.js gateway stop

步骤2：安装飞书插件

cd D:\openclawnode node_modules\openclaw\dist\index.js plugins install @openclaw/feishu

安装输出：

Installing @openclaw/feishu into C:\Users\liufy\.openclaw\npm…Linked peerDependency "openclaw" → D:\openclaw\node_modules\openclawConfig overwrite: C:\Users\liufy\.openclaw\openclaw.jsonInstalled plugin: feishuRestart the gateway to load plugins.

步骤3：重启Gateway

node D:\openclaw\node_modules\openclaw\dist\index.js gateway --port 18789

重启后验证日志：

http server listening (7 plugins: browser, device-pair, feishu,   file-transfer, memory-core, phone-control, talk-voice)starting feishu[aq] (mode: websocket)starting feishu[main] (mode: websocket)feishu[aq]: bot open_id resolved: ou_adeba2...feishu[main]: bot open_id resolved: ou_ec7703...

7个插件全部加载，两个飞书账号都连上了。

✅ 修复完成飞书Bot恢复正常回复。

六、模型精简结果

回到最开始的问题，Dashboard模型列表精简前后对比：

维度	精简前	精简后
Provider数量	7个	4个
模型数量	22个	16个
重复配置	有（glm/bigmodel, qwen/bailian）	无
占位符Key	有（deepseek部分）	无

保留的4个Provider：

bigmodel

（智谱GLM，Anthropic协议）：glm-5.1、glm-5、glm-4.7
bailian

（百炼聚合，OpenAI协议）：qwen3.6-plus、kimi-k2.5等9个
minimax

（OpenAI协议）：MiniMax-M2.7、Text-01
deepseek

（OpenAI协议）：V4-Pro、V4-Flash

七、两个重要提醒

⚠️ 提醒1：每次升级后必须重新安装飞书插件以后每次升级OpenClaw，都需要执行：plugins install @openclaw/feishu然后重启Gateway。这是外部插件机制的要求，升级core包不会自动更新外部插件。

💡 提醒2：Dashboard模型列表的修改方法OpenClaw有两层模型配置：全局配置：openclaw.json 中的 models.providers → Dashboard显示来源Agent配置：agents/{id}/agent/models.json → Agent级别，不影响Dashboard要修改Dashboard里的模型列表，只需编辑 openclaw.json，然后重启Gateway。

八、总结

这次踩坑的核心教训：

升级后第一件事不是看Dashboard，而是看日志里的插件加载情况
v2026.5.7之后，飞书是外部插件，需要手动安装
模型配置分两层，Dashboard看的是全局配置

如果你也在用OpenClaw，升级时记得检查插件列表，别像我一样被飞书不回消息折腾了一圈。

如果你对 AI 工具、AI 创作感兴趣

关注「爱默如深」，每周分享 AI 实战经验和踩坑记录

作者：老刘 | 公众号：爱默如深

—— 爱默如深 · OpenClaw技术系列 ——