夜雨聆风
一、版本概览
openclaw于2026年3月29日正式发布v2026.3.28最新版本，本次更新包含多项Breaking变更与功能优化，覆盖模型提供商适配、配置管理、插件系统、多平台交互、容器部署、CLI工具等多个核心模块，全面提升AI智能体框架的稳定性、安全性与易用性，以下为完整更新内容详解。
二、Breaking变更（不兼容更新）
1. Qwen提供商认证迁移
• 移除已弃用的 qwen-portal-authOAuth集成（适配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-fileSlack操作，通过现有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与passwordSecretRefs，正式支持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应用。
我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。
欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。
