乐于分享
好东西不私藏

OpenClaw v2026.3.22 发布

OpenClaw v2026.3.22 发布

OpenClaw v2026.3.22 正式发布:ClawHub 上线、浏览器重构、100+ 贡献者共创

写在前面

就在今天(3 月 23 日),OpenClaw v2026.3.22 正式版本发布

这是一个里程碑式的大版本:ClawHub 正式上线、浏览器架构重构、插件 SDK 全面升级、10+ 家新模型 Provider 加入、100+ 贡献者共同参与,带来约 200+ 项更新!

重要提示: 这是一个正式稳定版本,npm tag 为 latest,生产环境可安全使用。同日早些时候发布的 v2026.3.22-beta.1 为 Beta 预发布版本,正式版已完全替代。

📌 版本速览

Git 标签 v2026.3.22
npm 版本 2026.3.22(latest tag)
macOS 应用 已发布新构建
贡献者 100+ 位
更新项 约 200+ 项

🦞 核心亮点一:ClawHub 生态上线

这是本次更新最重要的生态级变化

ClawHub 是什么?

简单说,这是 OpenClaw 的官方插件市场。类似于 VS Code 的 Extensions Marketplace 或 npm,但专门为 OpenClaw 技能/插件设计。

主要变化:

安装优先级调整 - 裸 openclaw plugins install <package> 优先从 ClawHub 安装,npm 作为后备

原生 CLI 支持 - openclaw skills search|install|update 流程

Claude 市场兼容 - 支持 plugin@marketplace 安装

Bundle 发现 - 兼容 Codex、Claude、Cursor bundle

对用户的意义:

以后安装技能/插件,不需要再去 npm 搜索了,直接用 openclaw skills search 就能找到官方审核过的优质内容。

⚠️ 核心亮点二:浏览器架构重构(需迁移)

这是本次更新影响最大的 Breaking Change

发生了什么变化?

移除了传统 Chrome 扩展中继路径、捆绑扩展资产、driver: "extension"browser.relayBindHost 配置。

如何迁移?


# 升级后运行此命令自动迁移
openclaw doctor --fix

迁移后,配置将使用新的 existing-sessionuser 模式。

好消息: Docker、无头、沙盒和远程浏览器流程不受影响,仍使用原始 CDP。

🤖 核心亮点三:模型 Provider 大扩容

这次更新带来了10+ 家新模型 Provider,让你的 AI 选择更加丰富。

新加入的 Provider

Provider 核心更新
Anthropic Vertex 通过 Google Vertex AI 使用 Claude
Chutes 捆绑 Provider,支持 OAuth/API-key
Exa 捆绑 web-search 插件
Tavily 捆绑 Provider,暴露专用工具
Firecrawl 网页爬取和搜索
MiniMax 新增 M2.7/M2.7-highspeed
Xiaomi 切换到/v1 端点,新增 MiMo V2 Pro/Omni

OpenAI 默认模型变更

重要变化: OpenAI 默认模型切换到 openai/gpt-5.4,Codex 保持 openai-codex/gpt-5.4

🔐 必须注意的 Breaking Changes

⚠️ 升级前必读! 以下变更可能导致你的配置失效:

1. 插件 SDK 重构

新公共插件 SDK 表面是 openclaw/plugin-sdk/*,旧的 openclaw/extension-api 已移除,无兼容层

影响: 如果你有自定义插件,需要迁移到新 SDK。

2. 环境变量清理

移除 CLAWDBOT_*MOLTBOT_* 兼容名称,统一使用 OPENCLAW_* 前缀。

检查清单:


# 旧的(已失效)
export CLAWDBOT_CONFIG_PATH=xxx
export MOLTBOT_STATE_DIR=xxx

# 新的(正确)
export OPENCLAW_CONFIG_PATH=xxx
export OPENCLAW_STATE_DIR=xxx

3. 状态目录迁移

移除 .moltbot 状态目录自动检测/迁移。如仍使用 ~/.moltbot,需手动迁移到 ~/.openclaw


# 手动迁移命令
mv ~/.moltbot ~/.openclaw

4. 图像生成工具标准化

统一使用核心 image_generate 工具,移除 nano-banana-pro 文档/示例。

迁移方式:


# 在配置中使用
agents.defaults.imageGenerationModel.primary: "google/gemini-3-pro-image-preview"

📱 移动端增强

Android

聊天设置 UI 重构

系统感知暗色主题

Talk 语音合成迁移到网关

Nodes 新增 callLog.searchsms.search

iOS

新增 onboarding welcome pager

🛠️ 沙盒与运行时

可插拔沙盒后端:

新增 OpenShell 和 SSH 后端

支持 mirrorremote workspace 模式

SSH 沙盒支持 secret-backed key/certificate/known_hosts 输入

💡 升级建议

升级步骤


# 1. 备份配置(重要!)
cp -r ~/.openclaw ~/.openclaw.backup

# 2. 升级
openclaw update

# 3. 运行 Doctor 迁移配置
openclaw doctor --fix

# 4. 验证
openclaw --version

必须迁移项清单

浏览器配置 - 运行 openclaw doctor --fix

环境变量 - 检查是否使用旧前缀

状态目录 - 从 ~/.moltbot 迁移到 ~/.openclaw

自定义插件 - 检查是否使用旧 SDK

图像生成 - 切换到 agents.defaults.imageGenerationModel

📊 更新统计

类别 数量
总更新项 约 200+ 项
Breaking Changes 18 项(含安全修复)
功能新增 约 40+ 项
Bug 修复 约 120+ 项
安全修复 15+ 项
贡献者 100+ 位

🔗 相关链接

GitHub Release: https://github.com/openclaw/openclaw/releases/tag/v2026.3.22

ClawHub 文档:https://docs.openclaw.ai/tools/clawhub

浏览器迁移:https://docs.openclaw.ai/gateway/doctor

插件 SDK 迁移:https://docs.openclaw.ai/plugins/sdk-migration

状态目录迁移:https://docs.openclaw.ai/install/migrating

写在最后

v2026.3.22 是一个生态级更新。ClawHub 的上线标志着 OpenClaw 插件生态正式建立,浏览器架构重构为更稳定的未来打下基础,100+ 贡献者的共同参与展现了社区活力。

升级建议:

推荐升级 - 这是正式稳定版,生产环境可安全使用

⚠️ 务必备份 - Breaking Changes 较多,升级前备份配置

🔧 运行迁移 - 升级后运行 openclaw doctor --fix

如果你在升级过程中遇到问题:

1. 先查看本文的迁移清单

2. 参考官方文档的迁移指南

3. 在 GitHub Issues 或社区寻求帮助

如果你觉得本文有帮助:

欢迎点赞在看分享三连

分享给更多使用 OpenClaw 的朋友

关注我的公众号,获取更多 AI 实用教程

*本文原创,转载请注明出处*
*作者:Hope*

*公众号:Hope 的技术笔记*