OpenClaw v2026.3.22重磅发布，升级前必看的避坑指南
3月23日，OpenClaw发布了v2026.3.22，这是今年以来动作最大的一次更新。Breaking Changes一屏都截不完，涉及到插件安装、浏览器、文生图、插件SDK等好几个核心模块。当然也塞了不少新东西进来。
我把这波更新理了一遍，帮你判断要不要升、升的话要注意什么。
腾讯云coding plan
https://go.wangzhijie.com/txcoding
腾讯云低价云主机
https://go.wangzhijie.com/txecs
阿里云一键部署openclaw
https://go.wangzhijie.com/aliyunopenclaw
阿里云领7000万token
https://go.wangzhijie.com/aliyunai
阿里云轻量服务器68/年 99/年
https://go.wangzhijie.com/aliyun
阿里云百炼Coding Plan
https://go.wangzhijie.com/aliyuncoding
之前openclaw plugins install默认走npm，现在优先级换成了ClawHub，npm只当备胎。
这意味着什么？你之前从npm装的插件，以后可能会被ClawHub版本覆盖。如果ClawHub上没有这个包，才会继续用npm。
建议跑一下看看装的都是哪个源的：
openclaw plugins list
旧版的Chrome扩展中继、bundled扩展、driver: "extension"这些全部删了。
如果你之前配过浏览器扩展这条路，现在肯定用不了了。
解法：跑这个命令，它会帮你迁移配置：
openclaw doctor --fix
nano-banana-pro相关的文档、示例、skill wrapper全被清算了。
之前照着旧文档配过文生图的，需要改配置：
{
agents: {
defaults: {
imageGenerationModel: {
primary: "google/gemini-3-pro-image-preview"
}
}
}
}
openclaw/extension-api这个入口删了，没有兼容层，插件作者得换到openclaw/plugin-sdk/*下的具体子路径。
如果你自己写过插件，要去对照迁移文档
https://docs.openclaw.ai/plugins/sdk-migration 改一遍。
CLAWDBOT_*、MOLTBOT_*这些兼容性环境变量全部失效，.moltbot状态目录也不再生效。
检查一下自己有没有用到这些老名字，有的话赶紧换成OPENCLAW_*和~/.openclaw/。
slash命令部署从本地方式换成了Carbon reconcile。以后Discord重启不会再每次都触发OpenClaw本地重新部署命令了。
这个变化对大多数人影响不大，但如果你的Discord机器人slash命令不工作，可能就是这次换机制带来的问题。
-
Matrix插件换了官方matrix-js-sdk底层，如果之前装过Matrix插件要去看https://docs.openclaw.ai/install/migrating-matrix
-
媒体附件输出路径改了，浏览器/canvas快照迁移到details.media，通常不影响使用
-
Gateway Usage统计修复（会话轮换后不再少计）
-
Matrix网关重启后消息去重，防止旧消息被重复处理
Matrix插件换了官方matrix-js-sdk底层，如果之前装过Matrix插件要去看https://docs.openclaw.ai/install/migrating-matrix
媒体附件输出路径改了，浏览器/canvas快照迁移到details.media，通常不影响使用
Gateway Usage统计修复（会话轮换后不再少计）
Matrix网关重启后消息去重，防止旧消息被重复处理
Exa、Tavily、Firecrawl全部升级成官方bundled插件，不用自己手动装了：
- Exa：原生日期过滤、搜索模式选择
- Tavily：
tavily_search和tavily_extract直接用 - Firecrawl：搜索+抓取一体化
配置示例：
{
plugins: {
entries: {
exa: { enabled: true },
tavily: { enabled: true },
firecrawl: { enabled: true }
}
}
}
Chutes：官方插件，支持OAuth和API Key认证，动态模型发现。
Anthropic Vertex：通过Google Vertex AI跑Claude，适合已经在用GCP的用户。
- OpenAI默认换成
gpt-5.4，Codex换成openai-codex/gpt-5.4
- 新增
gpt-5.4-mini和gpt-5.4-nano支持
gpt-5.4，Codex换成openai-codex/gpt-5.4gpt-5.4-mini和gpt-5.4-nano支持之前沙箱只有Docker一种后端，现在可以选了：
| 后端 | 适合场景 |
|---|---|
| Docker | 本地容器隔离 |
| SSH | 远程任意机器 |
| OpenShell | 托管型，支持mirror和remote工作区模式 |
- 气泡消息可展开到canvas
- Sessions和Cron视图支持App内导航
- 主题圆角可调节
2.6 一些体验改善
几个值得了解的改善：超时大幅延长（从600秒到48小时，长任务不容易断了），Gateway启动变快（不再每次编译TypeScript，WhatsApp冷启动从几十秒降到几秒），首个消息不再报错（启动时prewarm主模型）。还有一些小功能比如/btw快速问答、per-agent思考模式独立设置、Android暗色主题跟随系统等，这些按需了解就行。
这次有几个安全补丁
- JVM/Gradle注入防护：阻止MAVEN_OPTS、GLIBC_TUNABLES、DOTNET_ADDITIONAL_DEPS等被利用来提权
- Voice Webhook DoS防护：预认证阶段body限制从1MB/30s压缩到64KB/5s，加了并发来源IP限制
- Exec审批修复：批准的命令现在正确绑定到实际可执行文件而非time包装器
建议升，但升之前做两件事：
第一步：跑诊断
openclaw doctor
看看有没有需要迁移的配置项。
第二步：过一遍Breaking Changes
- 插件来源有没有受影响的
- 浏览器配置是不是用的旧扩展方式
- 文生图有没有用nano-banana
- 有没有残留的旧环境变量
如果都没问题，升级后记得重启Gateway让新特性和配置生效。
