核心特性详解
xAI 生态深度整合
本次版本的重头戏是 xAI 提供商的全面升级。OpenClaw 将捆绑的 xAI 提供商迁移至 Responses API，新增了第一类 x_search 搜索功能，并自动启用 xAI 插件。这意味着使用 Grok 的用户现在可以无缝享受内置的网页搜索能力，无需手动切换插件配置。在 openclaw onboard 和配置流程中，系统会智能提示用户设置可选的 x_search，并支持通过共享的 xAI API 密钥选择 x_search 模型。
MiniMax 图像生成能力拓展
MiniMax 提供商新增了 image-01 模型的图像生成支持，覆盖图片生成和图到图编辑，并允许用户控制长宽比。同时，为保持技术栈现代化，该版本移除了 M2、M2.1、M2.5 和 VL-01 等旧版模型，仅保留 M2.7 系列。
插件审批机制重大升级
插件生态系统迎来关键性安全增强——新增异步 requireApproval 功能到 before_tool_call 钩子。这意味着插件现在可以暂停工具执行，并通过执行审批覆盖层、Telegram 按钮、Discord 交互或任意频道的 /approve 命令提示用户进行手动审批。/approve 命令已升级为统一处理执行和插件审批，并具备自动回退能力。
跨平台文件传输统一化
OpenClaw 推出了标准化的 upload-file 操作，现已明确支持 Microsoft Teams 和 Google Chat，并将 BlueBubbles 的文件发送功能整合到这一统一框架下。Slack 也新增了专门的 upload-file 动作，支持文件名、标题和评论的自定义覆盖。这一改进大幅简化了多平台文件传输的开发和使用流程。
Podman 容器部署简化
容器化部署变得更加友好。Podman 现在围绕当前无根用户简化容器设置，将启动助手安装至 ~/.local/bin，并文档化了主 CLI openclaw --container <name> ... 工作流，替代了之前需要专用 openclaw 服务用户的复杂配置。
CLI 和配置管理增强
新增 openclaw config schema 命令，可直接打印 openclaw.json 的 JSON Schema，方便开发者进行配置验证和 IDE 智能提示支持。配置迁移逻辑也更加智能，自动迁移超过两个月的旧配置，过时的遗留密钥现在会在验证时直接失败而非被重写。
重要问题修复
严重级修复
1. WhatsApp 无限回环崩溃
问题描述：自聊天 DM 模式下，机器人自己的外发回复被重新处理为新的入站用户消息，造成消息风暴 影响范围：使用 WhatsApp 自聊天功能的用户 解决方案：修复消息去重逻辑，阻断自回复的循环处理
2. Discord 网关崩溃（Issue #55403 和 #55421）
问题描述：Discord 网关重启时因 stale-socket 状态导致崩溃，进入重启循环 影响范围：所有 Discord 用户 解决方案：清理过期网关套接字、清除缓存恢复状态，采用失败关闭策略
3. GitHub Copilot 认证刷新死循环
问题描述：Copilot token 刷新因 setTimeout溢出进入热循环，消耗大量资源影响范围：使用 GitHub Copilot 认证的用户 解决方案：将大 expires_at值视为秒级时间戳，钳制远期运行时认证刷新计时器
4. Anthropic 提供者停止原因崩溃
问题描述：未处理的提供者停止原因（如 sensitive）直接导致代理运行崩溃影响范围：使用 Anthropic 模型的代理场景 解决方案：将停止原因作为结构化助手错误处理，保持代理运行稳定性
高影响修复
5. WhatsApp 引用误触提及
问题描述：引用消息中嵌入的 @提及被错误视为直接提及，错误触发提及门控 解决方案：区分引用消息内的提及和直接提及
6. Telegram 消息分割错误
问题描述：长消息在单词中间分割，严重影响可读性 解决方案：使用验证过的 HTML 长度搜索，确保在单词边界分割
7. OpenAI Codex 图像工具注册
问题描述：因缺失提供者注册或指令导致图像分析失败 解决方案：注册 Codex 媒体理解功能，将图像提示路由至 Codex 指令
8. 速率限制冷却策略优化
问题描述：一个模型的 429 错误会阻塞同一认证配置下的所有模型 解决方案：按模型隔离冷却作用域，使用阶梯式 30秒 / 1分钟 / 5分钟策略
9. Feishu WebSocket 幽灵连接
问题描述：监控停止/中止时未关闭 WebSocket 连接，导致幽灵连接持久化 解决方案：在监控停止时正确关闭 WebSocket 连接
10. Gemini 3.1 模型解析
问题描述：Google 提供者别名无法正确解析 Gemini 3.1 pro、flash 和 flash-lite 解决方案：传递实际运行时提供者 ID 并添加模板提供者回退
中影响修复
11. 控制 UI 敏感配置泄露
问题描述：敏感原始配置默认暴露，存在安全风险 解决方案：默认隐藏敏感配置，需要显式操作才能编辑
12. BlueBubbles 防抖空指针
问题描述：防抖刷新因空消息文本导致崩溃 解决方案：在入队边界清理空消息，添加独立组合器防护
13. iMessage 回复标签泄露
问题描述：内联 [[reply_to:...]]标签泄露到已发送文本解决方案：将 reply_to作为 RPC 元数据发送，清理出站消息中的指令标签
14. Matrix TTS 原生语音气泡
改进点：将自动 TTS 回复作为原生 Matrix 语音气泡发送，提升用户体验
升级建议
立即升级
如果您在使用以下功能，本次升级属于修复性升级，建议立即执行：
WhatsApp 自聊天功能 Discord 网关 GitHub Copilot 认证 Anthropic 代理（遭遇崩溃问题）
渐进升级
对于重度使用以下功能的开发者，新特性将显著提升开发体验和安全性，建议在测试环境验证后升级：
xAI / Grok 网页搜索 MiniMax 图像生成 插件审批机制 跨平台文件传输
配置检查清单
必须处理
Qwen OAuth 迁移：使用 Qwen 旧版 OAuth 的用户需迁移至 Model Studio openclaw onboard --auth-choice modelstudio-api-key
建议处理
配置备份：检查是否存在超过两个月的旧配置，升级前备份 openclaw.jsonPodman 用户：更新容器部署脚本，适配新的无根用户工作流 插件开发者：更新 before_tool_call钩子，利用新的异步审批机制
回滚预案
如遇兼容性问题，可通过版本管理工具回退至上一稳定版本，并检查配置迁移日志定位问题源头。
破坏性变更说明
Providers/Qwen
移除已弃用的 qwen-portal-auth OAuth 集成（针对 portal.qwen.ai），必须迁移至 Model Studio。
Config/Doctor
不再自动迁移超过两个月的旧配置，非常旧的遗留密钥现在会在验证时直接失败，而非在加载或 openclaw doctor 时被重写。
