一、版本概览

openclaw于2026年3月29日正式发布v2026.3.28最新版本，本次更新包含多项Breaking变更与功能优化，覆盖模型提供商适配、配置管理、插件系统、多平台交互、容器部署、CLI工具等多个核心模块，全面提升AI智能体框架的稳定性、安全性与易用性，以下为完整更新内容详解。

二、Breaking变更（不兼容更新）

1. Qwen提供商认证迁移

• 移除已弃用的qwen-portal-auth OAuth集成（适配portal.qwen.ai），该认证方式不再可用。
• 迁移方案：切换至Model Studio认证，使用命令openclaw onboard --auth-choice modelstudio-api-key完成配置。

2. 配置迁移规则调整

• 自动配置迁移功能仅保留近两个月内的配置项，超过两个月的旧版配置不再自动迁移。
• 极旧的遗留配置密钥加载时不再自动重写，而是直接触发验证失败，需手动更新配置。

三、核心功能更新与优化

（一）模型提供商适配增强

1. xAI（Grok）功能升级

• 捆绑的xAI提供商迁移至Responses API，新增原生x_search搜索能力。
• 自动启用xAI插件，无需手动切换，基于已有的网页搜索与工具配置，即可直接使用Grok认证与搜索流程。
• 新增Grok网页搜索插件引导：在openclaw onboard和openclaw configure --section web流程中，提供可选的x_search设置，包含共享xAI密钥的模型选择器。

2. MiniMax图像生成能力新增

• 新增MiniMax图像生成提供商，支持image-01模型。
• 核心能力：支持图像生成、图像到图像编辑，可自定义图像宽高比。
• 模型目录精简：仅保留M2.7模型，移除M2、M2.1、M2.5、VL-01等旧版模型。

3. OpenAI/Codex功能优化

• 为OpenAI与OpenAI Codex模型默认启用apply_patch功能。
• 对齐apply_patch的沙箱策略访问权限与写入权限，保障操作安全性。

（二）插件系统全面升级

1. 工具执行审批机制增强

• 插件钩子新增async requireApproval（before_tool_call钩子），可暂停工具执行，向用户发起审批请求。
• 审批渠道：支持执行审批覆盖层、Telegram按钮、Discord交互、任意频道/approve命令。
• 命令统一：/approve命令同时处理执行与插件审批，自动降级适配不同场景。

2. CLI后端与启动优化

• 捆绑的Claude CLI、Codex CLI、Gemini CLI推理默认配置迁移至插件层面，新增Gemini CLI后端支持。
• 命令替换：gateway run --claude-cli-logs替换为通用--cli-backend-logs，保留旧命令作为兼容别名。
• 自动加载：从显式配置引用中自动加载捆绑的提供商与CLI后端插件，无需手动配置plugins.allow条目。

3. 运行时与依赖优化

• 插件运行时系统命名空间暴露runHeartbeatOnce，支持触发单次心跳周期，可指定消息投递目标（如heartbeat: { target: "last" }）。
• 内存管理：预压缩内存刷新计划迁移至活跃内存插件合约，由内存核心模块控制刷新提示与目标路径策略，替代硬编码逻辑。
• 依赖保障：打包更新时预加载捆绑的@pierre/diffs运行时依赖，确保全局安装与更新后差异查看器正常加载。
• 主题兼容：加载捆绑的Pierre主题时移除JSON模块导入，适配新版Node.js构建环境。

4. 插件卸载与配置清理

• 卸载频道插件时，自动移除对应的channels.<id>配置项。
• 卸载预览与显式频道所有权规则对齐，内置频道与共享密钥不受影响。

（三）多平台交互功能优化

1. ACP（Agent Control Plane）频道绑定

• 为Discord、BlueBubbles、iMessage新增当前对话ACP绑定功能。
• 命令支持：/acp spawn codex --bind here可将当前聊天直接转为Codex工作区，无需创建子线程。
• 文档完善：明确区分聊天界面、ACP会话、运行时工作区的概念差异。

2. Slack文件操作增强

• 新增显式upload-file Slack操作，通过现有Slack上传通道处理文件上传。
• 支持自定义：可覆盖频道与私信的文件名、标题、备注信息。

3. 多平台文件发送统一

• 基于upload-file操作统一文件优先发送逻辑，新增Microsoft Teams、Google Chat显式支持。
• BlueBubbles文件发送通过upload-file实现，保留sendAttachment旧别名兼容。

4. Matrix平台功能优化

• TTS回复：自动TTS回复以原生Matrix语音气泡形式发送，替代通用音频附件。
• 媒体处理：保留入站媒体的发送者文件名，将originalFilename转发至saveMediaBuffer。
• 提及识别：支持识别matrix.to提及（可见标签为机器人房间显示名），requireMention: true的房间可在新版Matrix客户端正常响应。
• DM路由：选择外发直接房间时优先显式DM信号，避免严格双人回退房间覆盖真实DM。
• 认证配置：启动时解析环境变量-backed的accessToken与password SecretRefs，正式支持SecretRef格式的accessToken配置。
• 加密优化：E2EE加密图像缩略图使用thumbnail_file，未加密房间保留thumbnail_url预览，兼顾安全性与可用性。
• 依赖加载：通过createRequire(...)加载捆绑的@matrix-org/matrix-sdk-crypto-nodejs，保障打包ESM构建中E2EE媒体收发的原生绑定正常工作。

5. Microsoft Teams主动DM优化

• 发送用户消息时，优先选择最新的个人会话引用，避免回复指向陈旧DM线程。

6. Telegram论坛话题支持

• 保留论坛线程命令上下文的话题目标，/new、/reset命令始终路由至活跃话题。

7. Discord功能优化

• 回复格式：剥离内联回复标签时保留前导缩进，纯文本与代码块格式不受影响。
• 子代理通知：恢复BlueBubbles等扩展频道的完成通知投递。

（四）容器部署与系统优化

1. Podman容器简化

• 简化当前无root用户的容器设置，将启动助手安装至~/.local/bin目录。
• 工作流优化：推荐使用openclaw --container <name> ...主机CLI命令，替代专用openclaw服务用户。

2. 网关与代理稳定性增强

• 工具调用复用：构建HTTP/tools/invoke工具列表时复用会话工作区，默认推断会话代理工作区，避免工作区插件重复注册。
• 错误分类：将HTTP 410错误默认归类为可重试超时，同时保留会话过期、计费、认证等显式信号。
• 状态展示：openclaw daemon status优先展示轻量级探测的网关关闭原因， concrete认证/配对失败信息替代通用超时提示。

（五）CLI工具与配置管理

1. 新增配置Schema命令

• 新增openclaw config schema命令，可打印openclaw.json的生成JSON Schema，便于配置校验与开发。

2. TTS配置自动迁移

• 常规读取与密钥解析时自动迁移旧版语音配置，保留Doctor诊断功能。
• 移除常规运行时对旧版tts.<provider> API-key格式的降级支持。

3. Ollama思考模式优化

• thinkingLevel=off通过Ollama扩展请求路径传递，支持思考能力的Ollama模型接收think: false参数，避免静默生成隐藏推理Token。

4. Brave搜索适配

• 请求与缓存键生成前，将不支持的Brave国家过滤器归一化为ALL，避免VN等地区值触发上游422验证错误。

5. 入站附件处理

• inbound_claim钩子元数据传递完整入站附件数组，保留旧版单一媒体附件字段以兼容旧插件。

6. 代理压缩刷新

• 陈旧使用预飞行压缩时保留压缩后AGENTS刷新，保障Discord兼容上游beta构造器变更。

四、总结

代码地址：bgithub.xyz/openclaw/openclaw

openclaw v2026.3.28版本聚焦模型适配、插件安全、多平台交互、部署简化四大核心方向，通过Breaking变更清理历史包袱，同时新增多项实用功能，大幅提升AI智能体开发与运行的效率与安全性。开发者需重点关注Qwen认证迁移、配置迁移规则调整，按需升级模型与插件配置，充分利用xAI搜索、MiniMax图像生成、工具审批等新特性，构建更强大、更安全的AI应用。