OpenClaw 3.22 来了!一口气看完所有重磅更新

OpenClaw 3.22 来了！一口气看完所有重磅更新

“
这篇文章适合谁？
已经用着 OpenClaw 的同学 → 升级前必看
对 AI 助手接各种聊天软件感兴趣的同学 → 了解生态
开发者 / 插件作者 → 迁移指南章节重点看
阅读时间： 约 10 分钟

文章由Breeze的AI助手生成，注意甄别内容

序 · 先说个事

昨天，OpenClaw 发布了 3.22 版本。

这次确实值得专门写一篇。

原因很简单：变了很多，而且变的方向是对的。

插件生态从散兵游勇走向正规军，安全加固第一次被提到了显眼的位置，搜索工具、模型支持、沙盒架构这些"基础设施"一口气补齐了。

代价是——破坏性变更有 11 条，升级前不看完这章，真的可能会踩坑。

01 · ⚠️ 升级前必看：11 项破坏性变更

“
先说一件重要的事： 这次改动数量多，但每一条都有明确的迁移方案，不会让你"升完就炸"。建议先快速扫一遍，知道哪条跟自己相关，再仔细看。

一张表看清楚：这次动了什么

类别	数量	最高风险
插件体系（安装来源、SDK、消息接口）	5条	高（插件开发者必看）
配置与路径（环境变量、状态目录）	2条	中（手动配置过的用户）
浏览器支持	1条	低（doctor --fix 可修复）
安全加固	2条	中（高级用户）
第三方集成	1条	低（Matrix 用户）

1.1 插件安装来源改了：ClawHub 优先于 npm

一句话： 以后 openclaw plugins install xxx 默认从 ClawHub 安装，npm 只当备胎。

如果你受影响： 用私有插件，或者手动指定过 npm 包名的。需要确认你的插件已在 ClawHub 发布，或者安装时写完整 spec：npm:包名@版本。

# 以后安装插件的正确方式
openclaw plugins install clawhub:插件名

# 如果你坚持要用 npm
openclaw plugins install npm:包名@版本

1.2 Chrome 扩展模式被移除了

一句话：driver: "extension" 没了，配置方式变了。

如果你受影响： 之前用 Chrome 扩展模式配置浏览器的同学。

解决方法，运行一条命令：

openclaw doctor --fix

它会自动帮你迁移到新的 existing-session 模式，不需要手动改配置。

1.3 图片生成方式变了

一句话：nano-banana-pro 那个示例 skill 被移除了，内置图片生成现在走官方路径。

如果你是从文档里复制过示例配置的： 把这个配置删掉，或者改成：

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

OpenClaw 现在内置了图片生成能力，不需要额外安装 skill。

1.4 插件 SDK 完全重构

一句话： 旧接口没了，插件得重写适配。

OpenClaw 3.22 开放了新接口 openclaw/plugin-sdk/*，旧的 openclaw/extension-api 完全移除，没有兼容层。

插件开发者必读：

SDK 迁移指南
SDK 概览

1.5 消息发现接口三个旧方法移除

listActions、getCapabilities、getToolSchema 全部移除，统一换成 describeMessageTool(...)。

插件开发者必读。

1.6 Matrix 插件完全重写

基于官方 matrix-js-sdk 重写了，和旧版不兼容。正在用 Matrix 频道的同学需要重新配置。

参考：迁移文档

1.7 环境变量前缀换了

CLAWDBOT_* 和 MOLTBOT_* 全部废弃，切换为标准 OPENCLAW_* 前缀。

如果你在 systemd service 文件或者启动脚本里用过旧变量名，找出来改掉。

1.8 状态目录统一了

.moltbot 目录（~/.moltbot）的自动检测移除了。状态目录统一为 ~/.openclaw。

之前手动指定过状态路径的，检查一下配置里有没有写死旧目录。

1.9 安全加固：JVM 注入被屏蔽 ⚠️ 容易被忽略

OpenClaw 现在会主动拦截这些环境变量，不让它们传入 host exec 环境：

MAVEN_OPTS / SBT_OPTS / GRADLE_OPTS / ANT_OPTS
GLIBC_TUNABLES / DOTNET_ADDITIONAL_DEPS

这其实是好事，防止恶意代码通过构建工具注入。但如果你有自定义 Gradle 配置，GRADLE_USER_HOME 的行为也变了，需要确认一下是否受影响。

1.10 Discord 斜杠命令部署方式变了

以前 Discord 每次重启都会"抖动"一下，重新部署斜杠命令。3.22 切换为 Carbon reconcile 模式，彻底解决这个问题。

如果你管着 Discord Bot： 升级后第一次启动可能会有一次性的命令重新部署，之后就稳定了。

1.11 Voice Call Webhook 安全加固

未认证 webhook 的请求体预算从 1MB/30s 压缩到 64KB/5s，还加了 IP 并发限制。

这是一个防攻击的加固。如果你正常使用语音通话功能，不受影响。

02 · 30+ 新功能，这几个最值得注意

Breaking Changes 看完，来点让人开心的。

2.1 ClawHub 崛起——插件生态真正开放了

这是本版本最重要的一项新能力。

ClawHub 从一个"可选项"变成了"默认来源"，而且官方专门为它做了一整套 CLI 支持：

openclaw skills search   # 搜 ClawHub 上的 skill
openclaw skills install  # 安装
openclaw skills update  # 更新

以后找插件不需要去翻 GitHub 了，直接在终端搜就行。

2.2 Claude Marketplace 打通了

Claude 官方市场上发布的插件，现在可以直接安装到 OpenClaw 里。

简单说：Claude 官方生态和 OpenClaw 生态打通了，两边的插件可以互相用。

2.3 /plugins 命令——聊天窗口直接管插件

之前想看有哪些插件、想禁用某个插件，得去改配置文件。

现在直接在聊天窗口说 /plugins，就能看到列表和管理选项。

管理员可以通过 commands.plugins 配置开关决定要不要开放这个能力。

2.4 AI 模型支持又扩大了

模型	适合谁
Anthropic Vertex	Google Cloud 用户，想在 GCP 上用 Claude 的
Chutes	需要多模型切换，不想被单一供应商绑定的
GPT-5.4	默认模型升级了，用 OpenAI 的直接受益
GPT-5.4-mini / nano	想要更便宜更快的推理场景
DeepSeek	架构重构了，DeepSeek 用户体验更稳定

2.5 搜索工具三件套：Exa、Tavily、Firecrawl

这是我觉得对日常使用影响最大的一类更新。

以前想用 AI 搜网页，得自己搭 API。3.22 直接内置了三个插件：

Exa — 搜索+内容提取，适合需要精准结果的场景
Tavily — 专做 AI 搜索，在北美 AI 社区口碑很好
Firecrawl — 可以抓整个网站，适合做知识库

配置也很简单：

plugins:
entries:
exa:
config:
webSearch:
apiKey:"你的API Key"

2.6 沙盒架构升级：OpenShell + SSH

面向开发者的重要更新。

OpenClaw 3.22 把沙盒后端做成了可插拔架构，不再只有 Docker 一个选项：

OpenShell — 支持 mirror 模式和 remote workspace 模式
SSH — 可以连接远程服务器跑代码，适合"服务器就是开发机"的场景

sandbox list / recreate / prune 这些命令也升级了，现在是 backend-aware 的。

2.7 浏览器 MCP 支持扩大

browser.profiles.<name>.userDataDir 配置项，让 Brave、Edge 等 Chromium 系浏览器都可以接入 MCP。

如果你想让 AI 控制你的浏览器，之前只能 Chrome，现在选择多了。

2.8 捆绑包 MCP 服务终于能用了

Codex、Claude、Cursor 捆绑包现在可以被自动发现和安装，skills 会映射到 OpenClaw 的 skills 系统。

Context7 这类市场捆绑包现在可以直接通过 Pi 运行了——之前你配置完它只会停在"导入成功"那步，现在真的能用。

2.9 默认模型升级

OpenAI：GPT-5.4
Codex：openai-codex/gpt-5.4

后续模型更新也统一由单一模块管理，不用每次追着改配置了。

2.10 /btw 快速问答

这是一个"用完就离不开"的小功能。

/btw 可以回答一些不需要工具调用的问题，比如：

"当前会话用的什么模型？"
"这个会话开了多久了？"
"今天的用量是多少？"

答案在当前会话内交互显示，在飞书/Telegram 等外部渠道以普通消息回复。不消耗工具调用，查状态特别快。

2.11 Control UI 界面升级

几个实用的 UI 改进：

助手消息气泡新增「展开到 Canvas」按钮
Sessions 和 Cron 视图可以直接跳转了
圆角风格统一，Claw/Knot/Dash 三个组件视觉更一致

2.12 Agent 推理细粒度控制

每个 Agent 现在可以独立配置 thinking/reasoning/fast 默认值，不允许随便覆盖。

对运行多个 Agent 的同学来说，这个功能让管理清晰了很多。

2.13 支持从 GitHub main 安装

openclaw update --tag main

想追最新功能的开发者，这个很实用。不过提醒一句：main 分支不等于稳定版，生产环境慎用。

03 · Bug 修复快览

挑几个最影响日常使用的：

修复	影响
🔧 飞书图片/文件发送	之前一直报错，现在好了
🔧 Telegram 消息顺序	同聊天的消息不再乱序
🔧 OpenRouter 定价计算	usage.cost 不再一直是 0
🔧 Gateway 锁冲突	systemd/launchd 下不会频繁崩溃
🔧 Mistral 422 拒绝	`doctor --fix` 自动修旧配置
🔧 慢速设备健康检测	不再误报 Gateway 已死
🔧 Canvas 访问安全	匿名访问被禁止，更安全了

04 · 升级指南：四步搞定

第一步：备份

openclaw backup create

第二步（如需）：修复浏览器配置

openclaw doctor --fix

这条命令会处理 Chrome 扩展迁移，如果你没用过那个模式，跳过这步。

第三步：升级

npm install -g openclaw@latest

或者从 GitHub main：

openclaw update --tag main

第四步：验证

openclaw status

05 · 最后说几句

3.22 是 OpenClaw 历史上破坏性变更最多的版本之一。

但仔细看这些变更，方向是一致的：让生态更开放、让接入更安全、让基础设施更扎实。

ClawHub 配上 Marketplace，插件生态终于有了正规秩序；安全加固（JVM 注入屏蔽、Webhook 签名）补齐了之前一直被忽视的短板；搜索工具三件套让 AI 获取最新信息这件事，变得前所未有的简单。

如果你用 OpenClaw 已经一段时间了，这次升级值得认真对待。给自己留 20 分钟，把 Breaking Changes 过一遍，值得。

如果你还没开始用 OpenClaw，3.22 是一个不错的入坑节点。生态变好了，踩坑变少了。

下一版本据说还会有 MCP 工具生态和 Agent 协作能力。

保持关注。

文档来源：

GitHub Release：https://github.com/openclaw/openclaw/releases/tag/v2026.3.22
官方文档：https://docs.openclaw.ai/