如果你最近升级了 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 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. 环境变量名变更

如果你有脚本使用旧变量名，需要全部更新。

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 等），但也带来了一些问题。

建议：

1. 直接升级到 2026.3.23 或更新版本
2. 升级后必须运行 openclaw doctor --fix
3. 注意 breaking changes，更新你的配置

遇到其他问题？评论区留言。