夜雨聆风如果你最近升级了 OpenClaw 到 2026.3.22 版本，可能已经遇到了各种问题。这个版本是一次大重构，引入了很多破坏性变更，同时也带来了不少 bug。
别慌，这篇文章帮你梳理问题、影响范围，以及如何修复。
一、2026.3.22 的问题清单
1. 插件运行时缺失（最严重）
问题： npm 全局安装后，打包的插件运行时文件丢失，比如 WhatsApp 的 light-runtime-api.js、Matrix 的 runtime-api.js 等。
影响： 全局安装后插件直接报错，无法启动。
表现：
WhatsApp 报 Cannot find module 'light-runtime-api'Matrix 报 Cannot redefine property: resolveMatrixAccountStringValues
2. Chrome MCP 连接超时
问题： 旧版 Chrome 扩展中继路径被移除，但没有正确处理新模式的握手等待。
影响： macOS 上 Chrome MCP 反复超时，需要多次同意权限。
表现：
Chrome MCP handshake timeout反复弹出权限请求窗口
3. OpenAI Tokens 刷新失败
问题： 网关实时写入会把刚保存的凭证覆盖成内存中的旧值。
影响： 配置页面、Onboard 流程、token 粘贴都会被"还原"到过期的 token。
表现：
刚配置好的 OpenAI token 刷新后变回旧的 models auth paste-token写入失败
4. ClawHub macOS 认证失效
问题： 没有正确读取 macOS 的认证配置路径。
影响： macOS 用户执行 openclaw skills ... 时变成未登录状态。
表现：
技能浏览返回空列表 出现 429 错误
5. Mistral 模型 422 错误
问题： 默认的 max-token 设置太大，超过了 Mistral 的限制。
影响： 所有 Mistral 模型调用都返回 HTTP 422。
表现：
Mistral 422 reject模型调用全部失败
6. web_search 提供者不生效
问题： 使用了过时的默认提供者，而不是你配置的那个。
影响： 配置了 Tavily/Exa，但实际调用的还是默认搜索。
二、2026.3.23 的修复
2026.3.23 修复了上述所有问题：
| 问题 | 修复内容 |
|---|---|
| 插件运行时缺失 | 重新打包了所有运行时文件到 npm 包 |
| Chrome MCP 超时 | 正确等待浏览器标签页就绪 |
| OpenAI tokens | 修复了凭证覆盖问题 |
| ClawHub macOS | 正确读取 macOS 认证路径 |
| Mistral 422 | 降低默认 max-token 值 |
| web_search | 使用正确的运行时提供者 |
三、如何修复
方案一：升级到最新版本（推荐）
npm install -g openclaw@latest
# 或
openclaw update
升级后执行：
openclaw doctor --fix
这会自动修复：
Mistral 配置 插件配置残留 浏览器配置迁移
方案二：手动修复（如果暂时无法升级）
修复 Mistral 422 错误
编辑配置文件 ~/.openclaw/openclaw.json，找到 Mistral 相关配置，将 maxTokens 改为较小的值（如 4096）。
修复 Chrome MCP
将配置从 driver: "extension" 改为：
{
"browser": {
"profiles": {
"default": {
"mode": "existing-session"
}
}
}
}
修复 ClawHub 认证（macOS）
手动创建符号链接：
mkdir -p ~/.config/openclaw
ln -s ~/Library/Application\ Support/openclaw/auth.json ~/.config/openclaw/auth.json
四、2026.3.22 的 Breaking Changes
即使修复了 bug，你还需要注意这些破坏性变更：
1. 环境变量名变更
| 旧名 | 新名 |
|---|---|
CLAWDBOT_* |
OPENCLAW_* |
MOLTBOT_* |
OPENCLAW_* |
如果你有脚本使用旧变量名，需要全部更新。
2. .moltbot 目录不再自动迁移
如果你还保留着 ~/.moltbot 目录，需要手动迁移：
mv ~/.moltbot ~/.openclaw
或设置环境变量：
export OPENCLAW_STATE_DIR=~/.moltbot
3. Matrix 插件重写
旧版 Matrix 插件完全不兼容，需要按照迁移指南操作：https://docs.openclaw.ai/install/migrating-matrix
4. nano-banana-pro 技能移除
改用内置图片生成：
{
"agents": {
"defaults": {
"imageGenerationModel": {
"primary": "google/gemini-3-pro-image-preview"
}
}
}
}
5. 插件 SDK 变更
旧路径：openclaw/extension-api
新路径：openclaw/plugin-sdk/*
如果你有自定义插件，需要更新导入路径。
五、升级检查清单
升级到 2026.3.23 后，按这个清单检查：
运行 openclaw doctor --fix检查环境变量是否使用 OPENCLAW_*检查 .moltbot是否已迁移到.openclaw检查 Mistral 模型是否正常 检查 Chrome MCP 是否正常 检查 ClawHub 技能浏览是否正常 检查 Matrix 插件是否需要重配
总结
2026.3.22 是一次激进的重构版本，引入了很多新功能（ClawHub 原生支持、GPT-5.4、M2.7 等），但也带来了一些问题。
建议：
直接升级到 2026.3.23 或更新版本 升级后必须运行 openclaw doctor --fix注意 breaking changes，更新你的配置
遇到其他问题？评论区留言。
