xAI 搜索配置迁移

变更内容：移动 x_search 配置路径

• 旧路径：
  tools.web.x_search.*（核心配置）
• 新路径：
  plugins.entries.xai.config.xSearch.*（插件拥有）
• 认证标准化：
  plugins.entries.xai.config.webSearch.apiKey / XAI_API_KEY
• 迁移方式：
  openclaw doctor --fix

影响范围：使用 xAI Grok 搜索功能的用户需要迁移配置。

Firecrawl 配置迁移

变更内容：移动 Firecrawl web_fetch 配置路径

• 旧路径：
  tools.web.fetch.firecrawl.*（核心配置）
• 新路径：
  plugins.entries.firecrawl.config.webFetch.*（插件拥有）
• 路由变更：
  web_fetch 回退通过新的 fetch-provider 边界路由
• 迁移方式：
  openclaw doctor --fix

影响范围：使用 Firecrawl 网页抓取功能的用户需要迁移配置。

Task Flow 系统重构

这是 v2026.4.2 最核心的更新。恢复了核心 Task Flow 基础架构：

• 核心能力：
  托管 vs 镜像同步模式、持久化流状态/修订跟踪、openclaw flows 检查/恢复原语
• 新增功能：
  托管子任务生成 + 粘性取消意图、外部编排器可立即停止调度
• 实测体验：
  后台任务管理更可靠，任务丢失问题有完整恢复机制

Android 助手集成

Android 用户迎来助手角色入口点：

• Google Assistant App Actions 元数据
• Android 可从助手触发器启动 OpenClaw
• 提示词传递到聊天编辑器

使用场景：在 Android 设备上，可以通过 Google Assistant 直接唤醒 OpenClaw。

执行默认值优化

网关/节点主机执行默认为 YOLO 模式：

• 请求 security=full + ask=off
• 对齐主机审批文件回退 + 文档/doctor 报告
• 无提示默认值

实测体验：执行命令不再总是弹出审批提示，默认 YOLO 模式更流畅。

其他重要更新

• 提供商运行时钩子：
  转录策略、重放清理、推理模式调度
• 插件钩子增强：
  新增 before_agent_reply 钩子
• 飞书文档评论协作：
  专用 Drive 评论事件流
• Matrix 提及优化：
  发出符合规范的 m.mentions 元数据
• WhatsApp 表情反应：
  添加 reactionLevel 指导 agent 反应

安全增强：

• 提供商传输策略：
  集中化请求认证、代理、TLS 和头部整形
• Copilot 端点分类：
  硬化令牌派生的代理端点解析
• 流式头部合并：
  集中化默认和归属头部合并
• 图像生成提供商：
  通过共享提供商 HTTP 传输路径路由图像请求

稳定性修复：

• 网关执行回环：
  恢复遗留角色回退，解决配对问题
• 子代理权限：
  将仅管理员子代理网关调用固定到 operator.admin
• Slack mrkdwn 格式化：
  添加内置 Slack mrkdwn 指导
• WhatsApp 存在状态：
  在自聊天模式下连接时发送 unavailable 存在状态
• Matrix 流式：
  保持当前助手块的实时部分预览

必升级理由：

1. Task Flow 重构
    - 后台任务管理更可靠，支持完整的恢复机制
2. 安全配置迁移
    - xAI 和 Firecrawl 配置路径标准化，更符合插件架构
3. 多平台优化
    - WhatsApp、Matrix、Slack、飞书等平台体验改进
4. 稳定性修复
    - 大量提供商、网关、执行相关修复

⚠️ 注意事项

破坏性变更：使用 xAI 搜索或 Firecrawl 网页抓取功能的用户，升级后需要运行 openclaw doctor --fix 迁移配置。

升级步骤

# 1. 升级 OpenClaw

npm install -g openclaw@latest

# 2. 迁移配置（如果使用 xAI 或 Firecrawl）

openclaw doctor --fix

# 3. 重启网关

openclaw restart

OpenClaw v2026.4.2 是一个重要版本，主要聚焦于 Task Flow 系统重构、安全配置迁移、多平台优化 以及 大量稳定性修复。建议所有用户升级，特别是使用 xAI 搜索或 Firecrawl 网页抓取功能的用户。

这是 OpenClaw 继 v2026.4.1 后的又一个重要版本，共有 28 位贡献者 参与，社区反应热烈。升级后请务必运行 openclaw doctor --fix 迁移配置。