v2026.3.22
发布于 2026-03-23 · 翻译于
🎯 一句话总结:此版本大幅清理旧版配置与接口,标准化核心工具,并提升插件系统与沙箱安全性。
📋 更新要点(中文翻译)
1插件安装现在优先从 ClawHub 获取,npm 仅作为备用源。
2移除旧版 Chrome 扩展中继,需运行命令迁移浏览器配置。
3图像生成标准化为核心工具,旧版 nano-banana-pro 技能已移除。
4新增基于官方 SDK 的 Matrix 插件,旧用户需参考迁移指南。
5废弃旧版环境变量,统一使用 OPENCLAW_ 前缀。
6移除旧版 .moltbot 状态目录,请迁移至 ~/.openclaw。
7插件 SDK 接口更新,旧版 extension-api 不再兼容。
8沙箱环境阻止构建工具 JVM 注入,提升执行安全性。
▶查看英文原文(Release Notes)
## 2026.3.22
### Breaking
- Plugins/install: bare `openclaw plugins install <package>` now prefers ClawHub before npm for npm-safe names, and only falls back to npm when ClawHub does not have that package or version. Docs: https://docs.openclaw.ai/tools/clawhub
- Browser/Chrome MCP: remove the legacy Chrome extension relay path, bundled extension assets, `driver: "extension"`, and `browser.relayBindHost`. Run `openclaw doctor --fix` to migrate host-local browser config to `existing-session` / `user`; Docker, headless, sandbox, and remote browser flows still use raw CDP. Docs: https://docs.openclaw.ai/gateway/doctor and https://docs.openclaw.ai/tools/browser (#47893) Thanks @vincentkoc.
- Tools/image generation: standardize the stock image create/edit path on the core `image_generate` tool. The old `nano-banana-pro` docs/examples are gone; if you previously copied that sample-skill config, switch to `agents.defaults.imageGenerationModel` for built-in image generation or install a separate third-party skill explicitly.
- Skills/image generation: remove the bundled `nano-banana-pro` skill wrapper. Use `agents.defaults.imageGenerationModel.primary: "google/gemini-3-pro-image-preview"` for the native Nano Banana-style path instead.
- Plugins/SDK: the new public plugin SDK surface is `openclaw/plugin-sdk/*`; `openclaw/extension-api` is removed with no compatibility shim. Bundled plugins must use injected runtime for host-side operations (for example `api.runtime.agent.runEmbeddedPiAgent`) and any remaining direct imports must come from narrow `openclaw/plugin-sdk/*` subpaths instead of the monolithic SDK root. Docs: https://docs.openclaw.ai/plugins/sdk-migration and https://docs.openclaw.ai/plugins/sdk-overview
- Plugins/message discovery: require `ChannelMessageActionAdapter.describeMessageTool(...)` for shared `message` tool discovery. The legacy `listActions`, `getCapabilities`, and `getToolSchema` adapter methods are removed. Plugin authors should migrate message di