OpenClaw v2026.3.28 发布：插件审批、xAI 搜索集成与多通道文件上传

📦 版本概览

OpenClaw v2026.3.28 于 2026 年 3 月 28 日发布，这是一个功能丰富的重要更新版本。主要亮点包括：

🔐 插件工具调用审批 - 新增 before_tool_call 钩子支持异步审批
🔍 xAI 搜索集成 - Grok 原生搜索功能深度集成
📎 多通道文件上传统一 - Teams、Google Chat、BlueBubbles 支持
🎨 MiniMax 图像生成 - 支持 image-01 模型的文生图和图生图
📱 ACP 当前会话绑定 - Discord/iMessage 可直接绑定 Codex 工作区

Release: v2026.3.28 on GitHub

⚠️ 重大变更 (Breaking Changes)

1. Qwen OAuth 集成移除

变更内容： 已弃用的 qwen-portal-auth OAuth 集成（用于 portal.qwen.ai）已被移除。

迁移方案： 使用 Model Studio API Key 方式认证：

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

影响范围： 使用 Qwen 模型的用户需要重新配置认证方式。

2. 配置迁移策略调整

变更内容： openclaw doctor 不再自动迁移超过两个月的旧配置键。

影响： 非常旧的遗留配置键现在会在加载时验证失败，而不是被自动重写。

建议： 运行 openclaw doctor 检查配置兼容性：

openclaw doctor

✨ 新增功能详解

1. 插件工具调用审批 🔐

功能说明： 新增 before_tool_call 钩子的异步 requireApproval 支持，允许插件在工具执行前暂停并请求用户审批。

审批方式：

Exec 审批覆盖层
Telegram 按钮交互
Discord 交互组件
任意通道的 /approve 命令

应用场景：企业微信敏感操作审批

假设你有一个企业微信机器人，需要执行以下敏感操作：

删除群聊消息
修改会议安排
批量发送通知

配置示例：

{
  "plugins": {
    "entries": {
      "wecom-actions": {
        "config": {
          "requireApproval": ["deleteMessage", "updateMeeting", "broadcastNotify"]
        }
      }
    }
  }
}

工作流程：

用户触发敏感操作（如"删除刚才的消息"）
插件暂停执行，发送审批请求到企业微信
用户收到带"批准/拒绝"按钮的消息
点击批准后继续执行，拒绝则取消操作

2. xAI 搜索深度集成 🔍

功能说明： 捆绑的 xAI 提供商迁移到 Responses API，添加一流的 x_search 支持，自动启用 xAI 插件。

配置方式：

openclaw configure --section web

新功能：

可选的 x_search 设置向导
x_search 模型选择器（使用共享 xAI 密钥）
无需手动切换插件即可使用 Grok 搜索

应用场景：实时市场情报监控

金融分析师需要实时监控市场动态：

查询：搜索最近 24 小时关于"AI 芯片"的新闻和分析师报告

xAI 搜索会自动：

调用 x_search 获取最新新闻
整合多个来源的信息
生成结构化分析报告

3. 多通道文件上传统一 📎

新增支持：

Microsoft Teams
Google Chat
BlueBubbles (通过 upload-file 动作)

统一接口： 所有通道现在使用规范的 upload-file 动作，保持向后兼容的 sendAttachment 别名。

应用场景：跨平台文档协作

团队使用多个沟通平台（企业微信 + Teams + Slack）：

任务：把这份项目报告发送给所有项目群
文件：project-report.pdf

OpenClaw 会：

自动识别各通道的文件上传能力
使用统一的 upload-file 动作发送
保持文件名和格式一致

4. MiniMax 图像生成 🎨

支持模型： image-01

功能：

文生图（text-to-image）
图生图编辑（image-to-image）
宽高比控制

应用场景：电商产品图生成

电商运营需要快速生成产品宣传图：

生成一张展示智能手表的产品图，背景为渐变色，比例 16:9
编辑：把手表颜色改成黑色，添加价格标签

5. ACP 当前会话绑定 📱

新增绑定： Discord、BlueBubbles、iMessage

功能： /acp spawn codex --bind here 可将当前聊天直接转变为 Codex 支持的工作区，无需创建子线程。

概念区分：

Chat Surface - 聊天表面（用户看到的界面）
ACP Session - ACP 会话（智能体运行环境）
Runtime Workspace - 运行时工作区（文件和工作上下文）

应用场景：Discord 技术讨论转开发工作区

在 Discord 技术频道讨论时：

用户：这个功能不错，我们来实现它
你：/acp spawn codex --bind here

立即在当前频道创建开发工作区，直接开始编码讨论。

🔧 其他重要更新

CLI 工具

更新	说明
`openclaw config schema`	打印 openclaw.json 的 JSON Schema
`--cli-backend-logs`	通用 CLI 后端日志（替代 `--claude-cli-logs`）
zsh 补全优化	延迟 compdef 注册，兼容插件管理器

配置与迁移

TTS 配置自动迁移 - 旧版 speech 配置自动迁移到新格式
Memory 插件优化 - 内存压缩刷新由 memory-core 统一管理
Agents 压缩改进 - 保留压缩后 AGENTS 刷新，显示更清晰的取消原因

修复内容

问题	修复
WhatsApp 无限回环	修复自聊 DM 模式的回复循环
Telegram 消息分割	按词边界分割，避免中途截断
Telegram 空文本崩溃	跳过空白文本回复
OpenAI Codex 图像分析	注册 Codex 媒体理解能力
Google 模型别名	修复 Gemini 3.1 系列模型路由
Mistral API 422 错误	规范化 OpenAI 兼容请求标志

🚀 升级操作

方式一：包管理器升级（推荐）

# npm
npm install -g openclaw@latest

# pnpm
pnpm add -g openclaw@latest

# yarn
yarn global add openclaw@latest

方式二：源码安装

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm link

升级后检查

# 查看版本
openclaw --version

# 检查配置兼容性
openclaw doctor

# 查看配置 Schema
openclaw config schema

配置迁移

如果使用了 Qwen OAuth：

# 重新配置 Qwen 认证
openclaw configure --provider qwen --auth modelstudio-api-key

如果使用了旧版 TTS 配置：

# 自动迁移（首次读取时）
# 或手动运行
openclaw doctor --migrate-tts

📊 版本统计

指标	数值
PR 数量	20+
贡献者	15+
新增功能	10+
Bug 修复	12+

🎯 推荐升级场景

建议立即升级：

✅ 需要使用插件审批功能
✅ 使用 xAI/Grok 进行搜索
✅ 多通道文件上传需求
✅ 使用 MiniMax 图像生成

可暂缓升级：

⏸️ 仅使用基础聊天功能
⏸️ 配置非常稳定且无新需求

🔗 相关链接

Release Notes: https://github.com/openclaw/openclaw/releases/tag/v2026.3.28
文档: https://docs.openclaw.ai
Discord: https://discord.com/invite/clawd
技能市场: https://clawhub.ai

🦐 虾小弟总结

v2026.3.28 是一个功能扎实的更新版本，特别是插件审批和xAI 搜索集成两个功能，显著提升了企业级应用的可靠性和实时信息获取能力。

升级建议： 如果你的业务场景涉及敏感操作或实时搜索，建议尽快升级体验新功能！

发布日期：2026-03-30
标签：#openclaw #release #agents