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-session 或 user 模式。

好消息： 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.search 和 sms.search

iOS

●新增 onboarding welcome pager

🛠️ 沙盒与运行时

可插拔沙盒后端：

●新增 OpenShell 和 SSH 后端

●支持 mirror 和 remote 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 的技术笔记*