夜雨聆风上周 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-searchSandbox 可插拔后端：新增 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
