夜雨聆风
�� 龙虾养殖日记 | 飞书插件升级踩坑记:一次版本不兼容引发的＂血案＂
2026 年 3 月 25 日 星期三 晴
今天本是个普通的日子，直到我的 AI 助手突然”失声”了……
───
📱 问题发现：飞书智能体突然不说话了
早上打开飞书，像往常一样@我的 AI 助手，结果——石沉大海，毫无响应。
Telegram 那边一切正常，唯独飞书渠道彻底沉默。
💡 现象总结：
• ✅ Telegram 机器人正常工作
• ❌ 飞书智能体完全无响应
• 🔄 问题出现在系统升级之后
───
🔍 排查过程：像侦探一样挖日志
以下步骤为苦逼的龙虾自行排查，我们只需要压榨就好：
第一步：检查服务状态systemctl --user status openclaw-gateway服务显示 running，Gateway 正常运行，排除服务挂掉的可能。第二步：查看插件配置打开配置文件 ~/.openclaw/openclaw.json，发现：• 旧的 feishu 插件已被禁用 (enabled: false)• 新的 openclaw-lark 插件已启用 (enabled: true)这是升级后的正常状态——旧插件被新插件替代了。第三步：深挖日志真相tail -100 /tmp/openclaw/openclaw-2026-03-25.log | grep -i "error"关键错误浮出水面：Cannot find module 'openclaw/plugin-sdk'TypeError: (0 , _pluginSdk.normalizeAccountId) is not a functionCannot find module '/src/core/accounts' imported from /src/channel/monitor.js
附图为证：
──
🐛 根因分析：版本不兼容的”三角恋”
经过层层排查，问题终于水落石出：
|
组件 |
版本 |
状态 |
|
OpenClaw 主程序 |
2026.3.23-2 |
✅ 最新版 |
|
openclaw-lark 插件 |
2026.3.17 |
❌ 旧版本 |
核心问题：
1. 主程序升级后，normalizeAccountId 函数的导出方式发生了变化2. 旧版插件 (2026.3.17) 按照旧的方式导入，结果找不到函数3. 插件加载失败 → 飞书渠道无法启动 → 智能体"失声"
🎯 一句话总结：主程序向前跑了，插件还在原地，俩人”对不上暗号”了。
───
🛠️ 解决方案：手动升级插件
操作步骤
# 1.登录后台命令窗，手动安装最新版本
npx -y @larksuite/openclaw-lark update# 2. 重启 Gateway
openclaw gateway restart验证结果
飞书对话发送 /status ，回复了就是好了飞书智能体恢复正常！ 🎉
───
📝 经验总结：给同样踩坑的你
1. 升级顺序有讲究
✅ 正确：主程序升级 → 检查插件兼容性 → 必要时手动升级插件
❌ 错误：只升级主程序，不管插件
2. 日志是最好的侦探 【这个你可以让你的龙虾干】
遇到问题别慌，先查日志：# 实时查看日志tail -f /tmp/openclaw/openclaw-*.log# 筛选错误grep -i "error\|fail" /tmp/openclaw/openclaw-*.log
3. 插件版本要跟上
定期检查插件版本：npm view @larksuite/openclaw-lark version# 查看最新版cat package.json | grep '"version"'# 查看当前版本
4. 重要操作留后路
升级前备份配置和插件目录：
cp -r openclaw-lark openclaw-lark.bak───
🦞 龙虾日记小剧场
我：”今天飞书怎么不理我了？”
AI 助手：”老板，不是我不想理你，是插件版本太旧，我听不懂新暗号啊……”
我：”行吧，给你升个级。”
AI 助手：”得嘞，这下对上了！”
───
最后提醒：
OpenClaw 这类快速迭代的项目，插件和主程序的版本匹配很重要。以后升级前，记得先看看更新日志，有木有提到插件兼容性变化。
踩坑不可怕，可怕的是同一个坑踩两次 🦀
📍 记录于 2026-03-25
🏷️ 标签：#OpenClaw #飞书插件 #版本兼容 #技术踩坑 #AI 助手
🦞 龙虾养殖日记 · 持续更新中
养的是龙虾，写的是代码，过的是人生。