OpenClaw v2026.3.28 破坏性变更与升级指南

OpenClaw v2026.3.28的破坏性变更（Breaking Changes）主要涉及认证方式废弃、配置自动迁移策略收紧以及通道架构重构。
以下是本次升级必须处理的详细清单。

⚠️ 核心破坏性变更清单

🔧 深度解析与修复指南

1. Qwen 认证硬性迁移

这是影响最大的变更。如果你之前通过 qwen-portal-auth方式登录，升级后服务将直接中断。

• 原因：阿里云通义千问已正式弃用旧门户，全面转向 Model Studio。
• 操作：
  1 2	# 重新配置 Qwen openclaw onboard --auth-choice modelstudio-api-key

  • 输入从 dashscope.aliyun.com获取的 API Key 即可。

2. 飞书通道架构升级

Feishu 通道从单账号模式重构为多账号模式。
OpenClaw 升级到 2026.3.28 后，channels.feishu 配置结构发生变化，以下字段不再被支持：

• groupAllowFrom ❌

• groups ❌

• streaming ❌

• threadSession ❌

• footer ❌
  从 channels.feishu 配置中移除了不兼容的字段，保留了核心配置：

• enabled ✅

• appId / appSecret ✅

• domain ✅

• requireMention ✅

• dmPolicy / allowFrom ✅

• groupPolicy ✅

• 旧版（已失效）：

  1 2 3 4 5 6 7 8 9

  { "channels": { "feishu": { "appId": "cli_xxx", "groupAllowFrom": ["ou_xxx"], // ❌ 已废弃 "streaming": true // ❌ 已废弃 } } }

• 新版（修正后）：

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

  { "channels": { "feishu": { "enabled": true, "domain": "feishu", "accounts": { "default": { // ✅ 所有配置移至 accounts 内 "appId": "cli_xxx", "groupPolicy": "allowlist", "groupAllowFrom": ["ou_xxx"] } } } } }

• 注意：streaming（流式输出）和 threadSession（话题会话）已成为默认强制开启的特性，无法再通过配置关闭

🚀 升级后必做检查

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 1. 更新版本
npm install -g openclaw@latest

# 2. 诊断配置（自动修复部分问题）
openclaw doctor

# 3. 验证配置健康度
openclaw config validate

# 4. 重启服务
openclaw gateway restart

特别提醒：如果你使用了 MiniMax​ 的旧模型（如 m2.5），请立即更新配置为 m2.7，否则对话会直接报错 Model not found。

核心功能升级

1. xAI (Grok) 搜索深度集成

体验变化：Grok 的搜索能力从“插件”升级为“原生工具”，开箱即用。

• 自动启用：配置 web-search后，xAI 插件会自动激活，无需手动切换。
• 接口升级：底层迁移至 Responses API，x_search工具直接集成，搜索响应更实时。
• 配置简化：openclaw onboard向导现在会直接引导你配置 Grok 搜索，模型选择更直观

2. MiniMax 原生图像生成

体验变化：终于有了官方的文生图/图生图支持。

• 新增模型：正式支持 image-01模型，支持宽高比控制和局部编辑。
• 配置路径：通过 providers/MiniMax/image-01直接调用，不再依赖第三方集成，生成配图或封面更顺手

3. 插件“人工审批”机制（安全升级）

体验变化：给 AI 的自动化操作加了一道“安全锁”，防止误操作。

• 执行前确认：在 before_tool_call钩子中新增 requireApproval参数。当插件执行删除、发送敏感消息等操作时，会暂停并等待用户点击确认。
• 多端支持：支持 Telegram 按钮、Discord 交互、命令行弹窗等多种审批方式

4. ACP 工作区绑定体验优化

体验变化：在聊天软件中创建开发环境更便捷。

• 原地绑定：Discord、BlueBubbles、iMessage 支持 --bind here参数。现在可以直接在当前聊天窗口输入 /acp spawn codex --bind here，将当前会话直接转为 Codex 工作区，无需创建子线程

5. 多平台文件上传统一

体验变化：发送文件的操作逻辑在各平台趋于一致。

• 统一动作：Slack、Microsoft Teams、Google Chat 等平台统一使用 upload-file动作，支持覆盖文件名和注释，文件交互体验更标准化

🛠️ 底层体验优化（虽不可见，但更顺滑）