上周 OpenClaw 推出了 2026.3.22 版本，作为重度用户，我第一时间升级体验。说实话，这次更新力度不小，有几个破坏性变更如果没注意到，升级后可能直接懵圈。

我把踩过的坑和解决方案整理出来，帮你平滑升级。

升级命令

如果你赶时间，直接跑这个：

openclaw update
openclaw doctor --fix
openclaw gateway restart

但有几个变更需要你手动确认，下面展开说。

浏览器架构重构

这是影响最大的一个变更。

旧版 OpenClaw 的浏览器功能依赖 Chrome 扩展做中继，配置里会有 driver: "extension" 或 browser.relayBindHost 这种字段。新版把这个架构整个砍掉了，改用 existing-session 或 user 驱动模式。

如果你的 ~/.openclaw/openclaw.json 里还有旧配置，升级后浏览器工具会直接报错。

解决方案：

openclaw doctor --fix

这个命令会自动迁移配置。如果你想手动改，参考这个结构：

{
  "browser": {
    "profiles": {
      "default": {
        "driver": "existing-session",
        "userDataDir": "~/.config/google-chrome"
      }
    }
  }
}

Docker、headless、远程浏览器不受影响，它们本来就用原生 CDP。

插件安装源变了

openclaw plugins install xxx 现在优先从 ClawHub 找包，找不到才回退到 npm。

大部分情况下这是好事——ClawHub 是 OpenClaw 官方的技能市场，包的质量和版本管理更可控。但如果你之前装的是 npm 上的同名包，可能会装到不同版本。

显式指定源可以避免歧义：

# 强制从 npm 装
openclaw plugins install npm:your-plugin

# 强制从 ClawHub 装
openclaw plugins install clawhub:your-plugin

图像生成配置迁移

内置的 nano-banana-pro 技能包装器被移除了，图像生成统一走 image_generate 工具。

旧配置长这样（已废弃）：

{
  "skills": {
    "imageGeneration": "nano-banana-pro"
  }
}

新配置改成：

{
  "agents": {
    "defaults": {
      "imageGenerationModel": {
        "primary": "google/gemini-3-pro-image-preview"
      }
    }
  }
}

如果你有自定义的图像生成配置，升级前记得备份。

环境变量改名

旧的 CLAWDBOT_* 和 MOLTBOT_* 环境变量名被彻底移除，全部改成 OPENCLAW_*。

如果你的脚本里还有这种：

export CLAWDBOT_STATE_DIR=~/.clawdbot

改成：

export OPENCLAW_STATE_DIR=~/.openclaw

同理，如果你的状态目录还在 ~/.moltbot 下面，需要手动迁移：

mv ~/.moltbot ~/.openclaw

新版不再自动识别旧目录。

新功能亮点

踩完坑，说说值得升级的理由。

ClawHub 原生集成：搜索和安装技能更方便了：

openclaw skills search tavily
openclaw plugins install clawhub:tavily-search

Sandbox 可插拔后端：新增 OpenShell 和 SSH 后端，远程开发更灵活：

openclaw sandbox list
openclaw sandbox create --backend ssh

新模型支持：OpenAI 默认模型升级到 GPT-5.4，MiniMax 新增 M2.7，还支持通过 Google Vertex AI 调用 Claude。

Web 搜索工具：Tavily、Exa、Firecrawl 都有专用工具了，配置路径统一在 plugins.entries.xxx.config.webSearch.*。

安全加固：Exec 沙箱阻止了一堆 JVM 注入变量（MAVEN_OPTS、GRADLE_OPTS 等），语音通话 webhook 的预认证缓冲也收紧了。

升级后检查清单

# 确认版本
openclaw --version

# 修复配置
openclaw doctor --fix

# 重启服务
openclaw gateway restart

# 检查状态
openclaw status

# 打开控制面板
openclaw dashboard

如果浏览器工具报错，检查配置里的 driver 字段。如果通道连不上，确认没有遗漏旧环境变量。

小结

这次升级的核心改动是架构现代化——浏览器重构、SDK 迁移、环境变量统一。破坏性变更看着吓人，但 openclaw doctor --fix 能处理大部分情况。

建议升级前备份一下 ~/.openclaw/ 目录，万一出问题还能回滚。

你升级时遇到过最离谱的报错是什么？评论区聊聊。

参考：OpenClaw Releases