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 语音气泡，而非通用音频附件。

六、问题修复汇总 🔧

📌 核心修复

问题	说明
Agent 崩溃	修复未处理的敏感内容导致的崩溃
Google Gemini	修复 3.1 pro/flash/flash-lite 模型别名解析
图片分析	恢复 openrouter/minimax-portal 等的通用回退
WhatsApp	修复私聊自回声的无限循环问题
Telegram	修复长消息在单词边界分割（非单词中间）
Discord	修复重连时的网关清理问题
Feishu	修复 WebSocket 连接泄漏问题
Mattermost	修复 exec: SecretRef 机器人令牌的回复路径

📌 安全与隐私修复

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 模型版本
□ 插件加载状态
□ 各渠道连接状态
□ 敏感配置是否正常