OpenClaw 2026.3.28 发布：14项重大更新与迁移指南
OpenClaw 2026.3.28 带来了 xAI/Grok 深度集成、MiniMax 图像生成、插件工具审批流程等重大更新，同时废弃了一些旧功能。本文将详细解析这些变更和迁移方法。
目录
破坏性变更
1. Qwen 认证方式变更 ⚠️
旧方式（已废弃）: qwen-portal-auth OAuth 集成
新方式: Model Studio API Key
#### 迁移步骤
1. 获取新的 Model Studio API Key
访问 https://modelscope.cn 获取 API Key
2. 重新配置认证
openclaw onboard --auth-choice modelstudio-api-key
3. 更新 config.yaml
providers:
qwen:
api_key: ${QWEN_MODELSTUDIO_API_KEY}
#### 配置示例
providers:
qwen:
enabled: true
api_key:
value: ${QWEN_MODELSTUDIO_API_KEY}
models:
- qwen-turbo
- qwen-plus
- qwen-max
—
2. 配置迁移策略变更 ⚠️
变更: 超过两个月的旧配置自动迁移现在被禁用。
影响: 非常旧的配置键现在会验证失败，而不是被重写。
#### 建议操作
运行配置检查
openclaw doctor
查看需要更新的配置
openclaw doctor --check-deprecated
手动更新旧配置
openclaw config migrate --interactive
新增功能
3. xAI/Grok 深度集成
OpenClaw 现在深度集成 xAI（Grok），支持 Responses API 和原生搜索功能。
#### 主要特性
- Responses API — 新一代对话接口
x_search— 原生 X 平台搜索- 自动插件启用 — 无需手动切换
#### 配置方法
providers:
xai:
enabled: true
api_key: ${XAI_API_KEY}
default_model: grok-2
# 启用 X 搜索
web_search:
provider: x_search
auto_enable: true
#### 使用示例
使用 Grok 进行对话
openclaw chat --provider xai --model grok-2
启用 X 搜索的查询
@openclaw 搜索 X 上关于 OpenClaw 的最新讨论
4. xAI 引导流程
openclaw onboard 现在支持 xAI 配置：
openclaw onboard
选择：Configure web search
选择：xAI (Grok)
输入 XAI API Key
选择搜索模型
5. MiniMax 图像生成
MiniMax 现在支持图像生成功能！
#### 支持的模型
image-01— 高质量图像生成- 支持文生图和图生图编辑
- 可控制长宽比
#### 配置方法
providers:
minimax:
enabled: true
api_key: ${MINIMAX_API_KEY}
image_generation:
model: image-01
default_aspect_ratio: "16:9" # 或 1:1, 4:3, 9:16
#### 使用示例
生成图像
openclaw image generate --provider minimax --prompt "一只穿着西装的猫在写代码"
图生图编辑
openclaw image edit --provider minimax \
--input image.png \
--prompt "将背景改为未来城市风格"
6. 插件工具审批流程
重大更新: 插件现在可以在执行工具前要求用户审批！
#### 工作原理
用户请求 → 插件拦截 → 等待审批 → 执行/拒绝
#### 配置方法
plugins:
my-plugin:
hooks:
before_tool_call:
require_approval: true
# 审批方式
approval_methods:
- exec_overlay # 执行界面弹窗
- telegram_buttons # Telegram 按钮
- discord_interactions # Discord 交互
- slash_approve # /approve 命令
#### 使用示例
当插件工具需要审批时
🤖 插件 "my-plugin" 请求执行工具 "send_email"
请批准或拒绝：
[批准] [拒绝]
用户可以使用以下方式响应：
1. 点击界面按钮
2. 在 Telegram/Discord 中点击按钮
3. 发送 /approve 命令
7. ACP 频道绑定增强
ACP (Agent Collaboration Protocol) 现在支持更多频道的当前会话绑定。
#### 支持的频道
- Discord —
/acp spawn codex --bind here - BlueBubbles — iMessage 支持
- iMessage — 原生支持
#### 使用示例
将当前 Discord 频道变成 Codex 工作区
/acp spawn codex --bind here
创建一个子线程（旧方式）
/acp spawn codex --thread
#### 区别说明
| 方式 | 行为 | 适用场景 |
|——|——|———-|
| --bind here | 当前频道直接变成工作区 | 已有频道改造 |
| --thread | 创建子线程作为工作区 | 保持原频道整洁 |
8. OpenAI apply_patch 默认启用
OpenAI 和 OpenAI Codex 模型现在默认启用 apply_patch 功能。
providers:
openai:
models:
- gpt-4
- gpt-4-turbo
features:
apply_patch: true # 默认启用
sandbox_policy: write # 与 write 权限对齐
9. CLI 后端插件化
Claude CLI、Codex CLI 和 Gemini CLI 现在都作为插件运行：
plugins:
# 自动加载，无需手动启用
bundled_claude_cli:
enabled: true
bundled_codex_cli:
enabled: true
bundled_gemini_cli:
enabled: true
#### 日志配置
使用新的日志选项
gateway run --cli-backend-logs
旧选项仍然兼容
gateway run --claude-cli-logs # 自动映射到新选项
10. Podman 容器支持简化
Podman 容器设置现在更加简洁：
新的简化流程
podman run --rm -it \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest
本地 CLI 控制容器
openclaw --container my-openclaw status
#### 安装助手
安装启动助手到 ~/.local/bin
openclaw install-podman-helper
使用
~/.local/bin/openclaw-container start
11. Slack 文件上传动作
新增 upload-file Slack 动作，支持：
channels:
slack:
actions:
upload-file:
enabled: true
defaults:
filename: "{{original_name}}"
title: "{{description}}"
comment: "由 OpenClaw 上传"
12. Microsoft Teams 文件支持
开始统一文件发送操作：
channels:
teams:
actions:
upload-file:
enabled: true
max_file_size: 100MB
迁移指南
快速检查清单
1. 检查废弃配置
openclaw doctor --check-deprecated
2. 更新 Qwen 认证
openclaw onboard --auth-choice modelstudio-api-key
3. 验证配置
openclaw config validate
4. 重启服务
openclaw restart
配置更新示例
更新前
providers:
qwen:
auth_type: portal-oauth # 已废弃
更新后
providers:
qwen:
api_key: ${QWEN_MODELSTUDIO_API_KEY}
---
更新前
plugins:
allow:
- claude-cli # 不再需要显式允许
更新后（可选）
bundled 插件现在自动加载
总结
OpenClaw 2026.3.28 是一次功能丰富的更新：
1. AI 能力扩展 — xAI/Grok、MiniMax 图像生成
2. 安全增强 — 插件审批流程、配置验证
3. 集成深化 — ACP 多频道支持、Slack/Teams 文件上传
4. 架构优化 — CLI 后端插件化、Podman 简化
关键迁移点：
- Qwen 认证方式更新
- 旧配置自动迁移停止
下一步行动：
1. 运行 openclaw doctor 检查配置
2. 更新 Qwen 认证
3. 尝试新的 xAI/Grok 功能
4. 配置 MiniMax 图像生成
常见问题
Q: xAI API Key 在哪里获取？
A: 访问 https://x.ai/api 注册并获取 API Key。
Q: MiniMax 图像生成有费用吗？
A: 是的，按生成次数计费。查看 MiniMax 官方定价页面。
Q: 插件审批可以关闭吗？
A: 可以，将 require_approval 设为 false：
before_tool_call:
require_approval: false
Q: ACP bind 和 thread 有什么区别？
A:
--bind here— 直接使用当前频道作为工作区--thread— 创建新的子线程作为工作区
Q: Podman 和 Docker 有什么区别？
A: Podman 是无守护进程的容器工具，更适合 rootless 运行。OpenClaw 现在对两者都提供良好支持。
Q: 如何回退到旧版本？
A:
docker pull openclaw/openclaw:2026.3.27
docker run ... openclaw/openclaw:2026.3.27
参考来源
—
相关阅读：
