OpenClaw v2026.3.28 正式发布:这些重磅更新你不能错过

刚刚，OpenClaw 正式发布了 v2026.3.28 版本！这是一次重量级更新，带来了 xAI 全面升级、图片生成能力、插件钩子增强等多项重磅功能。同时也包含了一些需要关注的破坏性变更。让我带你快速了解这次更新的核心内容。

一、破坏性变更（Breaking Changes）⚠️

🔴 1. 通义千问（Qwen）认证方式变更

移除了 portal.qwen.ai 的旧版 OAuth 认证集成。

影响范围：所有使用通义千问的用户

迁移方案：

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

需要重新配置通义千问的认证方式，切换到新的 Model Studio API Key 模式。

🔴 2. 配置迁移策略调整

移除了超过2个月的历史配置自动迁移功能。

影响：

• 非常旧的遗留密钥现在会在加载时报错
• 不再自动重写旧配置
• 需要手动检查和更新配置

💡 建议：运行 openclaw doctor 检查当前配置，必要时手动更新旧密钥。

二、xAI/Grok 全面升级 🚀

本次更新最大的亮点之一是 xAI 平台的全面升级，现在 Grok 模型支持更多高级功能。

2.1 Responses API 升级

• ✅ 内置 xAI provider 已迁移到 Responses API
• ✅ 新增 x_search 搜索工具支持
• ✅ 自动启用 xAI Web 搜索插件

2.2 简化配置流程

现在使用 Grok 的 Web 搜索功能不再需要手动配置插件开关。

新用户引导流程支持一键配置 Grok，命令：openclaw onboard 或 openclaw configure --section web

三、MiniMax 图片生成 🖼️

🎨 新增图片生成能力

MiniMax 新增图片生成 provider，支持 image-01 模型：

• 文生图：
  根据文本描述生成图片
• 图片编辑：
  支持图生图编辑
• 比例控制：
  可自定义生成图片比例

⚠️ 注意：MiniMax 模型列表已精简，仅保留 M2.7 版本。已移除旧版 M2、M2.1、M2.5 和 VL-01 模型。如果你正在使用这些旧模型，需要迁移到 M2.7。

四、插件钩子增强 🔌

⏸️ 新增异步审批钩子

新增 before_tool_call 异步钩子，支持在工具执行前暂停并等待用户审批。

支持的审批方式：

• 执行审批弹窗
• Telegram 按钮
• Discord 交互按钮
• /approve
   命令（所有渠道）

现在 /approve 命令可以同时处理执行审批和插件审批，自动回退。

五、ACP 频道增强 📱

💬 当前会话绑定

Discord、BlueBubbles、iMessage 现在支持当前对话 ACP 绑定。

使用方式：

/acp spawn codex --bind here

可以将当前聊天直接转为 Codex 工作区，无需创建子线程。

六、其他重要更新

6.1 OpenAI Codex 图片工具

• Codex 模型现在支持图片理解
• 图片分析不再失败
• 文生图编辑功能增强

6.2 CLI 后端统一

• Claude CLI、Codex CLI、Gemini CLI 推理默认迁移到插件
• 新增 Gemini CLI 后端支持
• 新命令：openclaw config schema 打印 JSON Schema

6.3 文件上传统一

• 统一各平台的文件发送（Teams、Google Chat、BlueBubbles）
• Slack 新增上传文件动作
• 支持自定义文件名、标题和评论

6.4 Matrix TTS 升级

语音消息现在发送原生 Matrix 语音气泡，而非通用音频附件。

六、问题修复汇总 🔧

📌 核心修复

📌 安全与隐私修复

• Control UI 现在默认隐藏敏感原始配置
• Web 搜索密钥审计扩展到 Gemini、Grok、Kimi 等
• iMessage 不再泄漏 [[reply_to:...]] 标签

七、升级指南 📥

7.1 升级步骤

# 1. 备份当前配置 openclaw config export > backup.json # 2. 运行诊断 openclaw doctor # 3. 更新 OpenClaw npm update -g openclaw # 4. 检查日志 openclaw logs --lines 50

7.2 通义千问用户迁移

# 重新配置认证 openclaw onboard --auth-choice modelstudio-api-key

7.3 MiniMax 用户注意

如果你使用旧版 MiniMax 模型（M2、M2.1、M2.5、VL-01），需要：

• 检查配置中的模型名称
• 迁移到新的 M2.7 模型
• 更新 agents.defaults.model 设置

7.4 配置检查清单

✅ 检查清单：

• □ 通义千问认证方式
• □ MiniMax 模型版本
• □ 插件加载状态
• □ 各渠道连接状态
• □ 敏感配置是否正常