更新日期: 2026-04-03
更新版本: 2026.4.1 → 2026.4.2
更新优先级: 🟢 高（解决批准流程痛点）

---

🎯 核心亮点：默认 YOLO 模式

一句话总结：更新后，大部分命令不再需要 /approve 批准了！ 🎉

变更详情

Exec defaults: make gateway/node host exec default to YOLO mode 
by requesting `security=full` with `ask=off`

更新前：

• ❌ 执行 shell 命令需要等待用户批准
• ❌ 批准请求超时后命令失败
• ❌ 用户体验被打断

更新后：

• ✅ 主机执行默认使用 YOLO 模式（security=full + ask=off）
• ✅ 大部分命令自动执行，无需批准
• ✅ 自动化流程更流畅

---

📋 完整更新摘要

本次更新主要聚焦于：

1. 执行批准流程优化（核心亮点）
2. Task Flow 核心功能恢复
3. Provider 传输层安全加固
4. 两个 Breaking Changes（需用户注意）

---

⚠️ Breaking Changes（重要）

1. 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 搜索功能的用户需要更新配置

2. Firecrawl 插件配置路径迁移

• 变更: web_fetch 配置从 tools.web.fetch.firecrawl.* 迁移到 plugins.entries.firecrawl.config.webFetch.*
• 路由: web_fetch fallback 通过新的 fetch-provider 边界路由
• 迁移: 运行 openclaw doctor --fix 自动迁移旧配置
• 影响: 使用 Firecrawl 网页抓取的用户需要更新配置

---

🚀 其他核心改进

1. Task Flow 核心功能恢复

• 恢复内容: 核心 Task Flow 底层架构，支持 managed-vs-mirrored 同步模式
• 新功能:
  • 持久的 flow state/revision 追踪
  • openclaw tasks flow 检查/恢复原语
  • 托管子任务生成 + sticky cancel intent
  • 插件可通过 api.runtime.taskFlow 创建和管理 Task Flows
• 影响: 后台任务编排可独立于插件作者层持久化和操作
• 感谢: @mbelinky (#58930, #59610, #59622)

2. Android Assistant 集成

• 新功能: 添加 assistant-role 入口和 Google Assistant App Actions 元数据
• 功能: 可从 Android assistant 触发器启动 OpenClaw
• 自动发送: 聊天健康且空闲时自动发送 Google Assistant App Actions 提示
• 感谢: @obviyus (#59596, #59721)

3. 飞书评论事件流

• 新功能: 专用的 Drive 评论事件流
• 功能: 评论线程上下文解析、线程内回复、feishu_drive 评论操作
• 场景: 文档协作工作流
• 感谢: @wittam-01 (#58497)

4. 执行批准渠道优化

• 新功能: 自动启用 DM 优先的原生聊天批准
• 条件: 支持的渠道可从现有配置推断批准者
• 效果: Telegram 等渠道的批准体验更流畅（如果仍需批准）

5. 代理压缩优化

• 模型解析: /compact 和其他上下文引擎压缩路径一致解析 agents.defaults.compaction.model
• 通知: 添加 agents.defaults.compaction.notifyUser，🧹 Compacting context... 通知变为可选
• 感谢: @oliviareid-svg (#56710), @oguricap0327 (#54251)

---

🔧 重要修复

Provider 传输层安全加固（多项）

• 集中化策略: 统一 HTTP、stream、websocket 路径的请求认证、代理、TLS 和头部整形
• 安全: 阻止不安全的 TLS/runtime 传输覆盖
• 隔离: 代理跳转 TLS 与目标 mTLS 设置分离
• 感谢: @vincentkoc (#59682)

Provider 路由修复（多项）

• OpenRouter: 限制归属头仅应用于原生 OpenRouter 端点
• Copilot: 分类原生 GitHub Copilot API 主机
• 流式头部: 统一 OpenAI websocket、嵌入式 runner、代理流路径的头部合并
• 媒体 HTTP: 统一音频、视频、图片请求的 base URL 标准化
• OpenAI 兼容路由: 统一原生 vs 代理请求策略
• Anthropic 路由: 统一原生 vs 代理端点分类
• 感谢: @vincentkoc (#59644, #59542, #59469, #59433, #59608)

Gateway/Exec 循环修复

• 问题: 2026.3.31 后本地 exec 和 node 客户端出现 “pairing required” 错误
• 修复: 恢复空配对设备令牌映射的旧版角色 fallback
• 感谢: @openperf (#59092)

子代理网关调用修复

• 问题: sessions_spawn 在循环范围升级配对时出现 close(1008) "pairing required" 错误
• 修复: 将子代理网关调用限定为 operator.admin
• 感谢: @openperf (#59555)

---

🎯 更新建议

强烈推荐更新：

• ✅ 受批准流程困扰的用户（本次更新核心痛点）
• ✅ 使用 Task Flow 进行后台任务编排
• ✅ 使用 xAI 或 Firecrawl 插件（自动迁移配置）
• ✅ 需要 Android Assistant 集成
• ✅ 使用飞书 Drive 评论协作

更新后必做：

# 迁移旧配置（如果使用了 xAI 或 Firecrawl）
openclaw doctor --fix

---

📦 更新命令

# 通过 npm 更新
npm install -g openclaw@latest

# 或通过 OpenClaw 内置更新
openclaw update

更新后检查：

# 迁移配置（如需要）
openclaw doctor --fix

# 检查整体状态
openclaw doctor --non-interactive

---

📊 更新前后对比

场景	更新前	更新后
主机执行命令	需要 /approve	✅ 自动执行（YOLO 模式）
批准超时	命令失败	✅ 不再需要批准
Telegram 批准	可能看不到提示	✅ 自动启用 DM 批准
配置迁移	手动修改	✅ doctor --fix 自动迁移
Task Flow	不可用	✅ 恢复并增强

---

🔗 相关链接

• [GitHub Release]：https://github.com/openclaw/openclaw/releases/tag/v2026.4.2
• [完整 CHANGELOG]：https://github.com/openclaw/openclaw/blob/main/CHANGELOG.md
• [npm 包页面]：https://www.npmjs.com/package/openclaw

---

本文由 PM 墨者的 AI 助手「小墨」自动生成并人工审核