欢迎关注微信公众号「字与码」。

2026.3.22 先以 v2026.3.22-beta.1（npm v2026.3.22-beta.1，2026-03-23）预发布，同日稍后 v2026.3.22 打上正式标签。beta 说明里交代了和上一版类似的交付习惯：本 beta 未附新 macOS 应用包，稳定线 macOS 资产仍对应应用版本 2026.3.22，appcast.xml 刻意不变。稳定版 Release 在 beta 基础上又叠了极长一截 Fixes（网关启动路径、插件图拆分、安全与通道边角等），读变更时仍以 beta + 稳定 合起来理解。下面按主题归纳，不逐条翻译英文 bullet。

一、Breaking 与迁移：安装源、浏览器、生图与插件 ABI

插件安装：裸 openclaw plugins install <name> 现在 优先走 ClawHub，只有 ClawHub 没有对应包或版本时才回退 npm；npm 安全命名的包也会按这个顺序解析。官方文档在 ClawHub。同版还补上了 openclaw skills search|install|update、以及带追踪元数据的 openclaw plugins install clawhub:... 等路径，等于把「技能市场」和 CLI 装包绑在同一条故事线上。

Chrome / 浏览器：旧版 Chrome 扩展 relay 整段拆掉：不再提供 driver: "extension"、browser.relayBindHost 和捆绑扩展资源；本机浏览器请迁到 existing-session / user 档案，官方建议跑一遍 openclaw doctor --fix。Docker、无头、沙箱和远程 CDP 仍走原生 CDP。对仍要挂 Brave / Edge 等 Chromium 系 的用户，browser.profiles.*.userDataDir 可以在 existing-session 里显式指向各浏览器用户数据目录（#48170）。

生图路径：内置 image_generate 成为标准入口，旧的 nano-banana-pro 示例与捆绑 skill 移除；若以前抄过样例配置，应改用 agents.defaults.imageGenerationModel，或自行安装第三方 skill。原生「Nano Banana」式可走配置里的 google/gemini-3-pro-image-preview 等（见 Release 说明）。

插件 SDK：公开面统一为 openclaw/plugin-sdk/*，openclaw/extension-api 删除且无兼容垫片；通道侧共享 message 工具发现改为必须实现 ChannelMessageActionAdapter.describeMessageTool(...)，旧的 listActions / getCapabilities / getToolSchema 路径移除。Matrix 换成基于官方 matrix-js-sdk 的新插件，老用户需按 迁移指南 走一遍。

配置与历史包袱：CLAWDBOT_* / MOLTBOT_* 环境名和 ~/.moltbot 状态目录自动探测一并清理，统一 OPENCLAW_* 与显式 OPENCLAW_STATE_DIR / OPENCLAW_CONFIG_PATH。执行沙箱侧新增对 JVM / glibc / .NET 相关环境注入 的拦截（#49702）。Discord 原生斜杠命令默认改为 Carbon reconcile，减少重启时反复刷本地 deploy 路径造成的 slash command 抖动。

其它 Breaking 里还包括：语音通话 / webhook 在未验签时收紧 body 预算与并发；Matrix 线程绑定与去重语义；媒体回复 迁到 details.media；用量统计 把重置与已删归档会话算进 Usage 视图等——升级前最好对照官方 Release 的 Breaking 小节逐条打勾。

二、生态与「装完就能用」：市场、Bundle、CLI

Claude Marketplace 与 plugin@marketplace 安装/更新、列表与 Docker E2E 覆盖，把第三方技能与插件 discoverability 往前推了一步。Codex / Claude / Cursor bundle 可发现、安装，并把 bundle 里的 skills 映射进 OpenClaw skills；Claude bundle 的 settings.json 默认值会进嵌入式 Pi（并对 shell 覆盖做清理）。/plugins、/plugin 聊天命令（配合 commands.plugins 配置）让日常开关插件不必只依赖 CLI。

更新渠道：支持 openclaw update --tag main、安装器 --version main 或 npm/pnpm 直接装 GitHub main，方便追 HEAD 的自托管用户。Hooks 的安装与更新走 openclaw plugins，openclaw hooks 更偏展示与单钩控制，输出里也会标插件托管的 hook 信息。

三、模型与搜索：默认上移一层，供应面插件化

OpenAI 默认 setup 模型 切到 openai/gpt-5.4，Codex 仍 openai-codex/gpt-5.4，并把聊天、图像、TTS、转写、向量等默认值 收拢到同一模块，以后改默认不必到处改。Anthropic Vertex（Claude @ Google Vertex）进核心路由；Chutes、OpenRouter / GitHub Copilot / OpenAI Codex 等进一步 下沉到捆绑插件，带动态回退与鉴权交换。

网页与检索：Exa、Tavily、Firecrawl 均以捆绑插件形态提供专用工具或 web_fetch 对齐行为，配置落在各自的 plugins.entries.*.config.webSearch.* 下。MiniMax / xAI Grok / Z.AI GLM / Mistral / Xiaomi 等目录与定价元数据随上游 Pi SDK 同步；per-agent 支持 thinking / reasoning / fast 默认值，并在非法覆盖时 自动回退 到代理级默认。

四、沙箱、浏览器与运行时

沙箱从「几乎等于 Docker」变成 可插拔后端：内置 OpenShell（含 mirror / remote 工作区模式），以及核心 SSH 沙箱（密钥、证书、known_hosts 等走 Secret）。list / recreate / prune 等命令也按后端分流，而不是假设只有容器。

浏览器侧除上文 userDataDir 外，Launch 时 不再强行多开空白标签（#52451）这类小改动会改善自动化脚本里「多出一个 about:blank」的干扰。

五、交互、控制面与移动端

/btw：在当前会话里提一个 不污染后续上下文 的侧问，TUI 里可收起，外通道有明确 BTW 回复形态。Control UI：聊天气泡 展开到画布、从 Sessions/Cron 跳进会话；外观里 圆角统一 并增加 Roundness 滑条；Usage 区样式与响应式也整了一轮。Android 侧 系统级暗色主题、Talk 合成迁到网关 talk.speak（密钥留在网关）、通话记录 / 短信搜索 等节点能力继续补全。

六、通道与集成（摘要点）

Telegram：自定义 Bot API apiRoot 贯穿发送、探测、doctor、媒体下载；论坛主题 首条消息可 LLM 自动命名；topic-edit、静默错误回复 等运维向选项更齐。飞书：结构化 审批与快捷动作卡片、流式卡片上的 推理流、以及 ACP / 子会话在部分会话形态下的绑定，都是在企业 IM 里把「能聊」推进到「能办事」。

七、网关性能、可靠性与安全补丁（稳定线增量的大头）

这一版 Fixes 里值得单独记几类：网关启动 从编译中的扩展 TypeScript 改为优先加载 dist/extensions 预编译产物，冷启动 WhatsApp 等通道从「几十秒」拉回「秒级」量级（#47560）；通道与模型目录懒加载、预热线程主模型，避免首条消息报 Unknown model。安全面覆盖 Windows 上结构化本地媒体路径触发 SMB 握手、Bonjour/DNS-SD 未解析端点 fail-closed、配对与设备 token、exec 审批与 jq safe-bin、Webhook 前置鉴权与 body 限制 等，和 Breaking 里的语音 webhook 收紧是同一条「默认不信任」主线。

---

小结：2026.3.22 把 插件与技能的发现—安装—更新 收到 ClawHub / 市场 / bundle 一条链上，同时用 硬性 Breaking 清掉浏览器扩展 relay、旧环境名和旧 SDK 面；模型与搜索继续插件化与目录同步；沙箱可插拔后自托管的可选后端更多。稳定版相对 beta 的最大增量在 网关启动路径、插件运行时图拆分、以及成批安全与通道修复，适合升级前预留一轮回归。

参考

• 预发布：v2026.3.22-beta.1
• 稳定：v2026.3.22
• 相对上一稳定标签的代码范围：v2026.3.13-1…v2026.3.22
• 文档：docs.openclaw.ai · 仓库 CHANGELOG.md「2026.3.22」