OpenClaw v2026.3.22重磅发布，升级前必看的避坑指南

工作 2026-03-24 onebyte 手机阅读

OpenClaw v2026.3.22重磅发布，升级前必看的避坑指南-一字节.OneByte

前言

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

一、6个Breaking Changes，踩到一个就够呛

1.1 插件安装源悄悄改了

之前openclaw plugins install默认走npm，现在优先级换成了ClawHub，npm只当备胎。

这意味着什么？你之前从npm装的插件，以后可能会被ClawHub版本覆盖。如果ClawHub上没有这个包，才会继续用npm。

建议跑一下看看装的都是哪个源的：

openclaw plugins list

1.2 浏览器MCP彻底重构

旧版的Chrome扩展中继、bundled扩展、driver: "extension"这些全部删了。

如果你之前配过浏览器扩展这条路，现在肯定用不了了。

解法：跑这个命令，它会帮你迁移配置：

openclaw doctor --fix

1.3 文生图管道合并

nano-banana-pro相关的文档、示例、skill wrapper全被清算了。

之前照着旧文档配过文生图的，需要改配置：

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

1.4 插件SDK换了一套

openclaw/extension-api这个入口删了，没有兼容层，插件作者得换到openclaw/plugin-sdk/*下的具体子路径。

如果你自己写过插件，要去对照迁移文档
https://docs.openclaw.ai/plugins/sdk-migration 改一遍。

1.5 旧环境变量彻底废除

CLAWDBOT_*、MOLTBOT_*这些兼容性环境变量全部失效，.moltbot状态目录也不再生效。

检查一下自己有没有用到这些老名字，有的话赶紧换成OPENCLAW_*和~/.openclaw/。

1.6 Discord命令部署换了机制

slash命令部署从本地方式换成了Carbon reconcile。以后Discord重启不会再每次都触发OpenClaw本地重新部署命令了。

这个变化对大多数人影响不大，但如果你的Discord机器人slash命令不工作，可能就是这次换机制带来的问题。

其他Breaking Changes（快速了解）

  • Matrix插件换了官方matrix-js-sdk底层，如果之前装过Matrix插件要去看https://docs.openclaw.ai/install/migrating-matrix

  • 媒体附件输出路径改了，浏览器/canvas快照迁移到details.media，通常不影响使用

  • Gateway Usage统计修复（会话轮换后不再少计）

  • Matrix网关重启后消息去重，防止旧消息被重复处理

二、新功能盘点

2.1 搜索工具三连发

Exa、Tavily、Firecrawl全部升级成官方bundled插件，不用自己手动装了：

  • Exa：原生日期过滤、搜索模式选择
  • Tavily：tavily_search和tavily_extract直接用
  • Firecrawl：搜索+抓取一体化

配置示例：

{
  plugins: {
    entries: {
      exa: { enabled: true },
      tavily: { enabled: true },
      firecrawl: { enabled: true }
    }
  }
}

2.2 新AI提供商

Chutes：官方插件，支持OAuth和API Key认证，动态模型发现。

Anthropic Vertex：通过Google Vertex AI跑Claude，适合已经在用GCP的用户。

2.3 模型更新

  • OpenAI默认换成gpt-5.4，Codex换成openai-codex/gpt-5.4
  • 新增gpt-5.4-mini和gpt-5.4-nano支持

2.4 可插拔沙箱

之前沙箱只有Docker一种后端，现在可以选了：

后端 适合场景
Docker 本地容器隔离
SSH 远程任意机器
OpenShell 托管型，支持mirror和remote工作区模式

2.5 Control UI改进

  • 气泡消息可展开到canvas
  • Sessions和Cron视图支持App内导航
  • 主题圆角可调节

2.6 一些体验改善

几个值得了解的改善：超时大幅延长（从600秒到48小时，长任务不容易断了），Gateway启动变快（不再每次编译TypeScript，WhatsApp冷启动从几十秒降到几秒），首个消息不再报错（启动时prewarm主模型）。还有一些小功能比如/btw快速问答、per-agent思考模式独立设置、Android暗色主题跟随系统等，这些按需了解就行。

三、安全修复

这次有几个安全补丁

  1. JVM/Gradle注入防护：阻止MAVEN_OPTS、GLIBC_TUNABLES、DOTNET_ADDITIONAL_DEPS等被利用来提权
  2. Voice Webhook DoS防护：预认证阶段body限制从1MB/30s压缩到64KB/5s，加了并发来源IP限制
  3. Exec审批修复：批准的命令现在正确绑定到实际可执行文件而非time包装器

四、升级建议

建议升，但升之前做两件事：

第一步：跑诊断

openclaw doctor

看看有没有需要迁移的配置项。

第二步：过一遍Breaking Changes

  • 插件来源有没有受影响的
  • 浏览器配置是不是用的旧扩展方式
  • 文生图有没有用nano-banana
  • 有没有残留的旧环境变量

如果都没问题，升级后记得重启Gateway让新特性和配置生效。

OpenClaw v2026.3.22重磅发布，升级前必看的避坑指南-一字节.OneByte