OpenClaw 2026.3.22-23 重大更新:开发者生态全面重构,这些变化你需要知道

📌 省流速读

• 核心观点：OpenClaw 2026.3.22 是一次里程碑式的大版本更新，插件生态全面重构，新增多个 AI 模型和 Web 搜索provider，开发体验大幅提升。
• 关键点1：ClawHub 插件市场升级为默认安装源，npm 不再是首选
• 关键点2：Plugin SDK 全面升级至 openclaw/plugin-sdk/*，旧代码需要迁移
• 关键点3：支持 GPT-5.4、Claude via Google Vertex、AI Chutes 等新模型
• 关键点4：新增 Exa、Tavily、Firecrawl 三个 Web 搜索provider
• 适合谁看：AI 开发者、OpenClaw 用户、需要构建 AI Agent 的技术团队

如果你正在使用 OpenClaw，这周的更新你绝对不能错过。

2026 年 3 月 22 日和 23 日，OpenClaw 连续发布两个版本，其中 2026.3.22 是一个 Breaking Changes 密集的大版本。这次更新涉及插件生态、模型支持、Web 工具、安全加固等多个维度，变化相当大。

本文帮你梳理这次更新的核心内容，以及你需要做的适配工作。

1. 插件生态重构：ClawHub 升级为默认源

1.1 安装优先级变更

最关键的变化：openclaw plugins install 现在优先查询 ClawHub，只有在 ClawHub 不存在该包时才回退到 npm。

这意味着：

• 如果你之前依赖 npm 安装插件，需要确认该插件是否已入驻 ClawHub
• 官方推荐使用 openclaw plugins install clawhub:<plugin-name> 明确指定来源
• ClawHub 技能市场也支持 openclaw skills search|install|update 原生命令

1.2 多个插件市场支持

除了 ClawHub，新增了：

• Claude Marketplace：支持 plugin@marketplace 格式安装
• Codex、Claude、Cursor Bundle：支持从主流 AI 工具的插件包直接安装

1.3 Matrix 插件重写

全新的 Matrix 插件基于官方 matrix-js-sdk 重写，支持：

• 消息去重（Gateway 重启后不重复处理）
• Thread 绑定改进
• 迁移文档已发布：迁移指南^[1]

如果你之前使用旧版 Matrix 插件，请务必查看迁移文档。

2. Plugin SDK 全面升级

2.1 重大 Breaking Change

旧版的 openclaw/extension-api 已被移除，全新 Plugin SDK 迁移至 openclaw/plugin-sdk/*。

主要变化：

• 旧版直接导入方式不再支持
• 宿主端操作需使用注入的 runtime（如 api.runtime.agent.runEmbeddedPiAgent）
• 必须从具体的子路径导入，不能从 SDK 根路径导入

官方提供了详细的迁移文档：

• SDK 迁移指南^[2]
• SDK 概述^[3]

如果你是插件开发者，这周需要检查你的插件是否兼容新 SDK。

2.2 消息发现机制更新

旧的 listActions、getCapabilities、getToolSchema 方法已移除，必须迁移到新的 ChannelMessageActionAdapter.describeMessageTool(...) 接口。

3. 模型支持全面进化

3.1 OpenAI 模型更新

• 默认模型升级：从 GPT-5.3 升级到 GPT-5.4
• Codex 保持：Codex 仍使用 openai-codex/gpt-5.4
• 新模型兼容：新增对 gpt-5.4-mini 和 gpt-5.4-nano 的原生支持

3.2 新增模型 Provider

3.3 模型配置集中化

OpenAI 的 chat、image、TTS、transcription、embedding 默认配置现在集中在单一共享模块，未来默认模型更新将更加高效。

4. Web 搜索工具三连发

三个全新的 Web 搜索provider已内置：

4.1 Exa

• 支持日期过滤、搜索模式选择
• 配置路径：plugins.entries.exa.config.webSearch.*

4.2 Tavily

• 专用工具：tavily_search 和 tavily_extract
• 配置路径：plugins.entries.tavily.config.webSearch.*

4.3 Firecrawl

• 工具：firecrawl_search 和 firecrawl_scrape
• 作为 web_fetch 的后备方案

5. 开发者工具更新

5.1 Sandbox 能力扩展

• SSH Sandbox：新增核心 SSH 沙箱后端，支持密钥、证书、known_hosts 认证
• OpenShell 后端：支持 mirror 和 remote workspace 模式
• 沙箱管理命令 sandbox list/recreate/prune 现在支持多后端

5.2 浏览器 MCP 改进

• 移除旧版 Chrome 扩展中继路径（需运行 openclaw doctor --fix 迁移配置）
• 支持 browser.profiles.<name>.userDataDir，可附加到 Brave、Edge 等 Chromium 浏览器
• 修复 macOS Chrome 附加流程的用户超时问题

5.3 控制 UI 优化

• 聊天气泡增加 "expand-to-canvas" 按钮
• Sessions 和 Cron 视图中新增会话导航
• 主题圆角统一化，Knot 主题改为黑红配色（WCAG 2.1 AA 对比度）
• 新增 Diagnostics/CLI/Secrets/ACP/MCP 配置图标

6. 安全加固

6.1 环境隔离加强

新增以下安全阻止：

• JVM 注入阻止：MAVEN_OPTS、SBT_OPTS、GRADLE_OPTS、ANT_OPTS
• glibc 漏洞利用阻止：GLIBC_TUNABLES
• .NET 依赖劫持阻止：DOTNET_ADDITIONAL_DEPS

6.2 语音 Webhook 防护

• 签名验证前置于 Body 读取
• 预认证 Body 限制：64KB / 5s
• 单 IP 并发预认证请求限制

6.3 CSP 控制 UI

• 计算 inline blocks 的 SHA-256 哈希
• 包含在 script-src CSP 指令中
• 默认阻止 inline scripts，只允许显式哈希的 bootstrap 代码

7. Bug 修复亮点（2026.3.23）

以下是本次修复中值得关注的问题：

• Auth 凭证回滚：修复 Configure/Onboard 流程中 token 粘贴后自动回滚到过期值的问题
• Operator 权限保留：修复设备认证旁路后 operator scopes 丢失的问题
• ClawHub macOS 认证：修复 macOS 上技能浏览使用未登录状态的问题
• Mistral 输出限制：降低 max-token 默认值，避免 422 错误
• OpenRouter 定价递归：修复 bootstrap 阶段无限递归问题
• Discord 命令权限：修复权限拒绝时返回误导性完成提示的问题

8. 你需要做什么？

立即行动

1. 运行 openclaw doctor --fix：修复浏览器配置迁移
2. 检查插件兼容性：如果使用第三方插件，确认已在 ClawHub 可用
3. 迁移 Plugin SDK：如有自建插件，阅读迁移文档并更新导入路径

值得尝试

1. 体验新模型：GPT-5.4 已设为默认，Anthropic Vertex 支持 Claude
2. 试用新搜索工具：Exa、Tavily、Firecrawl 各有特色
3. 探索 SSH Sandbox：如果需要远程执行环境

关于我们

Techub：解构前沿技术，重塑应用场景，把未来的智能生态提前剧透给你。

✦ 前沿与生态｜具身智能 · AI Agent · 智能家居

✦ 硬核与落地｜非标自动化 · AI 驱动研发 · 智能机电融合

一场充满未知的逆旅。点击上方关注，我们一起捕捉科技奇点。

参考来源

• OpenClaw Releases - GitHub^[4]
• ClawHub 文档^[5]
• Plugin SDK 迁移指南^[6]
• Matrix 迁移指南^[7]

引用链接