v2026.3.22-beta.1
发布于 2026-03-23 · 翻译于
🎯 一句话总结:核心变化:重构插件与配置体系,标准化图像生成工具,移除旧版兼容项并迁移至 OPENCLAW 命名空间。
📋 更新要点(中文翻译)
1插件安装优先使用 ClawHub 源,仅在缺失时回退至 npm。
2移除旧版 Chrome 扩展中继,运行 doctor --fix 迁移浏览器配置。
3图像生成标准化为 image_generate 工具,移除 nano-banana-pro 技能。
4推荐使用 agents.defaults.imageGenerationModel 配置原生图像生成。
5新增基于 matrix-js-sdk 的 Matrix 插件,旧用户需参考迁移指南。
6移除旧版 CLAWDBOT 和 MOLTBOT 环境变量,统一使用 OPENCLAW 前缀。
7状态目录迁移至 ~/.openclaw,不再自动检测旧版 .moltbot 目录。
8插件 SDK 更新为 openclaw/plugin-sdk/*,旧扩展 API 已移除。
9消息发现机制更新,插件需迁移至 describeMessageTool 方法。
10本次为 Beta 预发布,macOS 应用构建仍保持在稳定版本不变。
▶查看英文原文(Release Notes)
Pre-release for npm beta tag `v2026.3.22-beta.1`.
No new macOS app build is attached to this beta. macOS assets remain on stable app version `2026.3.22`, and `appcast.xml` is intentionally unchanged in this pre-release.
### 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 `ChannelMessageAct