OpenClaw v2026.3.28 发布：来看看有没有你中意的新特性？

核心特性详解

xAI 生态深度整合

本次版本的重头戏是 xAI 提供商的全面升级。OpenClaw 将捆绑的 xAI 提供商迁移至 Responses API，新增了第一类 x_search 搜索功能，并自动启用 xAI 插件。这意味着使用 Grok 的用户现在可以无缝享受内置的网页搜索能力，无需手动切换插件配置。在 openclaw onboard 和配置流程中，系统会智能提示用户设置可选的 x_search，并支持通过共享的 xAI API 密钥选择 x_search 模型。

MiniMax 图像生成能力拓展

MiniMax 提供商新增了 image-01 模型的图像生成支持，覆盖图片生成和图到图编辑，并允许用户控制长宽比。同时，为保持技术栈现代化，该版本移除了 M2、M2.1、M2.5 和 VL-01 等旧版模型，仅保留 M2.7 系列。

插件审批机制重大升级

插件生态系统迎来关键性安全增强——新增异步 requireApproval 功能到 before_tool_call 钩子。这意味着插件现在可以暂停工具执行，并通过执行审批覆盖层、Telegram 按钮、Discord 交互或任意频道的 /approve 命令提示用户进行手动审批。/approve 命令已升级为统一处理执行和插件审批，并具备自动回退能力。

跨平台文件传输统一化

OpenClaw 推出了标准化的 upload-file 操作，现已明确支持 Microsoft Teams 和 Google Chat，并将 BlueBubbles 的文件发送功能整合到这一统一框架下。Slack 也新增了专门的 upload-file 动作，支持文件名、标题和评论的自定义覆盖。这一改进大幅简化了多平台文件传输的开发和使用流程。

Podman 容器部署简化

容器化部署变得更加友好。Podman 现在围绕当前无根用户简化容器设置，将启动助手安装至 ~/.local/bin，并文档化了主 CLI openclaw --container <name> ... 工作流，替代了之前需要专用 openclaw 服务用户的复杂配置。

CLI 和配置管理增强

新增 openclaw config schema 命令，可直接打印 openclaw.json 的 JSON Schema，方便开发者进行配置验证和 IDE 智能提示支持。配置迁移逻辑也更加智能，自动迁移超过两个月的旧配置，过时的遗留密钥现在会在验证时直接失败而非被重写。

重要问题修复

严重级修复

1. WhatsApp 无限回环崩溃

• 问题描述：自聊天 DM 模式下，机器人自己的外发回复被重新处理为新的入站用户消息，造成消息风暴
• 影响范围：使用 WhatsApp 自聊天功能的用户
• 解决方案：修复消息去重逻辑，阻断自回复的循环处理

2. Discord 网关崩溃（Issue #55403 和 #55421）

• 问题描述：Discord 网关重启时因 stale-socket 状态导致崩溃，进入重启循环
• 影响范围：所有 Discord 用户
• 解决方案：清理过期网关套接字、清除缓存恢复状态，采用失败关闭策略

3. GitHub Copilot 认证刷新死循环

• 问题描述：Copilot token 刷新因 setTimeout 溢出进入热循环，消耗大量资源
• 影响范围：使用 GitHub Copilot 认证的用户
• 解决方案：将大 expires_at 值视为秒级时间戳，钳制远期运行时认证刷新计时器

4. Anthropic 提供者停止原因崩溃

• 问题描述：未处理的提供者停止原因（如 sensitive）直接导致代理运行崩溃
• 影响范围：使用 Anthropic 模型的代理场景
• 解决方案：将停止原因作为结构化助手错误处理，保持代理运行稳定性

高影响修复

5. WhatsApp 引用误触提及

• 问题描述：引用消息中嵌入的 @提及被错误视为直接提及，错误触发提及门控
• 解决方案：区分引用消息内的提及和直接提及

6. Telegram 消息分割错误

• 问题描述：长消息在单词中间分割，严重影响可读性
• 解决方案：使用验证过的 HTML 长度搜索，确保在单词边界分割

7. OpenAI Codex 图像工具注册

• 问题描述：因缺失提供者注册或指令导致图像分析失败
• 解决方案：注册 Codex 媒体理解功能，将图像提示路由至 Codex 指令

8. 速率限制冷却策略优化

• 问题描述：一个模型的 429 错误会阻塞同一认证配置下的所有模型
• 解决方案：按模型隔离冷却作用域，使用阶梯式 30秒 / 1分钟 / 5分钟策略

9. Feishu WebSocket 幽灵连接

• 问题描述：监控停止/中止时未关闭 WebSocket 连接，导致幽灵连接持久化
• 解决方案：在监控停止时正确关闭 WebSocket 连接

10. Gemini 3.1 模型解析

• 问题描述：Google 提供者别名无法正确解析 Gemini 3.1 pro、flash 和 flash-lite
• 解决方案：传递实际运行时提供者 ID 并添加模板提供者回退

中影响修复

11. 控制 UI 敏感配置泄露

• 问题描述：敏感原始配置默认暴露，存在安全风险
• 解决方案：默认隐藏敏感配置，需要显式操作才能编辑

12. BlueBubbles 防抖空指针

• 问题描述：防抖刷新因空消息文本导致崩溃
• 解决方案：在入队边界清理空消息，添加独立组合器防护

13. iMessage 回复标签泄露

• 问题描述：内联 [[reply_to:...]] 标签泄露到已发送文本
• 解决方案：将 reply_to 作为 RPC 元数据发送，清理出站消息中的指令标签

14. Matrix TTS 原生语音气泡

• 改进点：将自动 TTS 回复作为原生 Matrix 语音气泡发送，提升用户体验

升级建议

立即升级

如果您在使用以下功能，本次升级属于修复性升级，建议立即执行：

• WhatsApp 自聊天功能
• Discord 网关
• GitHub Copilot 认证
• Anthropic 代理（遭遇崩溃问题）

渐进升级

对于重度使用以下功能的开发者，新特性将显著提升开发体验和安全性，建议在测试环境验证后升级：

• xAI / Grok 网页搜索
• MiniMax 图像生成
• 插件审批机制
• 跨平台文件传输

配置检查清单

必须处理

• Qwen OAuth 迁移：使用 Qwen 旧版 OAuth 的用户需迁移至 Model Studio

  openclaw onboard --auth-choice modelstudio-api-key
  

建议处理

• 配置备份：检查是否存在超过两个月的旧配置，升级前备份 openclaw.json
• Podman 用户：更新容器部署脚本，适配新的无根用户工作流
• 插件开发者：更新 before_tool_call 钩子，利用新的异步审批机制

回滚预案

如遇兼容性问题，可通过版本管理工具回退至上一稳定版本，并检查配置迁移日志定位问题源头。

破坏性变更说明

Providers/Qwen

移除已弃用的 qwen-portal-auth OAuth 集成（针对 portal.qwen.ai），必须迁移至 Model Studio。

Config/Doctor

不再自动迁移超过两个月的旧配置，非常旧的遗留密钥现在会在验证时直接失败，而非在加载或 openclaw doctor 时被重写。