今天刚发布的 OpenClaw v2026.4.5 存在两个比较严重的升级问题,可能导致升级后 CLI 或 Gateway 完全无法工作。如果你正在考虑升级,建议先看完这篇。
问题一:Gateway 启动失败 — 插件路径校验误杀
影响范围: 所有从 git 源码安装的用户
升级到 2026.4.5 后,执行 openclaw gateway 会直接报错:
Error: plugin entry path escapes plugin root: ./src/channel.js而且 openclaw doctor --fix 也会触发同样的错误,等于连自救的通道都被堵死了。
原因: 新版本引入的插件加载器增加了路径安全校验,要求入口路径必须限制在插件目录内。但大量内置 channel 插件(feishu、discord、irc、matrix 等)使用 ./src/channel.js 这种带 ./ 前缀的相对路径定义入口,校验逻辑把合法路径误判为"逃逸"。
临时解决方案:
把 openclaw.json 中插件配置的入口路径从 ./src/channel.js 改为 src/channel.js(去掉前面的 ./)。两种写法效果完全一样,但校验只认第二种格式。
或者直接回退到 v2026.4.3。
问题二:npm 升级后 CLI 命令全部报错
影响范围: 通过 npm/pnpm 全局安装的用户
通过 openclaw update 或 npm install -g openclaw 升级后,执行任何命令都可能遇到:
Error: Cannot find module '@buape/carbon'
Error: Cannot find module '@larksuiteoapi/node-sdk'这不是个别依赖缺失,而是一整批内置插件的运行时依赖都没装上,包括 Discord、飞书、Telegram、WhatsApp、Slack 等几乎所有渠道插件的依赖包。
临时解决方案:
手动补装缺失的依赖:
npm install -g @buape/carbon @larksuiteoapi/node-sdk grammy @grammyjs/runner @grammyjs/transformer-throttler @whiskeysockets/baileys @slack/web-api @slack/bolt discord-api-types @discordjs/voice然后运行 openclaw doctor 完成修复。
建议
- • 如果你还没升级:先观望,等修复版本出来再升
- • 如果你已经升级且遇到问题:按上面的临时方案处理
- • 两个问题都指向 v2026.4.5 在发布前的测试覆盖不够充分,新引入的安全校验和依赖打包流程都没有经过充分验证
夜雨聆风