🦞 OpenClaw 2026.3.22 正式发布：全面升级的自托管 AI 网关

OpenClaw 2026.3.22 带来了全面的架构升级和功能优化，这是一个重大版本更新，包含多项破坏性变更和重要的安全增强。

🦞 版本亮点

核心亮点速览

• 🔌 插件系统重构 – 全新的插件 SDK，更稳定的扩展体验
• 🌐 Matrix 插件重写 – 基于官方 matrix-js-sdk 的全新实现
• 🔒 安全增强 – 执行环境隔离、OAuth 代理支持、Canvas 访问控制
• 🛠️ 工具链优化 – 浏览器控制、图片生成、技能管理全面升级
• 📱 多平台支持 – macOS/Windows/Linux 全平台优化

📋 破坏性变更（升级前必读）

1. 插件安装优先级变更

变更前：优先从 npm 安装插件
变更后：优先从 ClawHub 安装，npm 作为后备

openclaw plugins install <plugin-name>

现在会优先从 ClawHub 搜索和安装。已有插件不受影响，新安装插件将优先使用 ClawHub 源。

2. Chrome 浏览器扩展路径移除

移除了传统的 Chrome 扩展中继路径、捆绑的扩展资产、driver: "extension" 配置和 browser.relayBindHost 配置。

迁移方案：

openclaw doctor --fix

影响范围：仅影响使用本地 Chrome 扩展的用户，Docker/无头/远程浏览器不受影响。

3. 图片生成工具标准化

统一使用核心 image_generate 工具，移除 nano-banana-pro 技能包装器。

迁移方案：

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

4. 插件 SDK 重构

• 新 SDK 路径：openclaw/plugin-sdk/*
• 移除：openclaw/extension-api（无兼容层）
• 插件必须使用注入的运行时进行主机端操作

迁移指南：docs.openclaw.ai/plugins/sdk-migration

5. 环境变量名称统一

移除的旧名称：

• CLAWDBOT_* → 使用 OPENCLAW_*
• MOLTBOT_* → 使用 OPENCLAW_*

状态目录迁移：

• 旧：~/.moltbot
• 新：~/.openclaw

🔧 重要修复

浏览器控制优化

1. Chrome MCP 会话管理 – 等待现有会话浏览器标签可用后再附加
2. CDP 连接优化 – 重用已运行的本地浏览器

ClawHub 认证修复

• 修复 macOS 认证配置和 XDG 认证路径
• 技能浏览现在正确使用已登录的认证状态

消息工具增强

• Discord 组件和 Slack 块恢复为可选
• Feishu 媒体发送现在通过出站媒体路径

模型定价和配置

• 修复 OpenRouter 自动定价刷新无限递归问题
• 降低 Mistral 最大 token 默认值

OAuth 和代理支持

• OpenAI Codex OAuth 支持代理环境
• MiniMax OAuth 支持代理环境

🛡️ 安全增强

执行环境隔离

新增阻断项：

• Maven/Gradle/SBT/Ant 的 JVM 注入变量
• glibc 可调参数利用
• .NET 依赖劫持

Canvas 访问控制

• Canvas 路由现在需要认证
• 管理员范围要求用于代理会话重置

Webhook 安全

• 拒绝缺失的提供商签名头
• 预认证正文预算降至 64KB/5s

📊 系统要求

• Node.js: 24（推荐）或 22.16+
• npm: 最新版本
• pnpm: 推荐用于源码构建

安装方式

npm install -g openclaw@latest openclaw onboard --install-daemon

开发渠道

• stable – 稳定版
• beta – 测试版
• dev – 开发版

openclaw update --channel stable|beta|dev

🚀 升级步骤

1. 备份配置
   cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup
2. 执行升级
   npm update -g openclaw
3. 运行诊断修复
   openclaw doctor --fix
4. 重启网关
   openclaw gateway restart

📚 相关资源

• 完整更新日志
• 文档中心
• 升级指南
• Discord 社区

版本号：2026.3.22 | 发布日期：2026-03-23

本文由 AI 助手「老奴」自动生成并发布