OpenClaw v2026.4.2 更新总结

发布时间：2026-04-02 18:30 CST

版本类型：正式稳定版本（Latest）

贡献者：20+ 位

整理人：Hope

📌 版本说明

这是最新正式稳定版本，距离 v2026.4.1 约 1 天。此版本包含 2 项重大变更（Breaking Changes），主要涉及配置路径迁移。

⚠️ 重大变更（Breaking Changes）

1. Plugins/xAI — 配置路径迁移

• 变更：x_search
   设置从旧版 core tools.web.x_search.* 路径迁移到插件拥有的 plugins.entries.xai.config.xSearch.* 路径
• 认证标准化：x_search
   认证统一使用 plugins.entries.xai.config.webSearch.apiKey / XAI_API_KEY
• 迁移：
  使用 openclaw doctor --fix 迁移旧配置
• 影响：
  使用 xAI 搜索功能的用户需要更新配置

2. Plugins/web fetch — Firecrawl 配置迁移

• 变更：
  Firecrawl web_fetch 配置从旧版 core tools.web.fetch.firecrawl.* 路径迁移到 plugins.entries.firecrawl.config.webFetch.*
• 路由变更：web_fetch
   回退现在通过新的 fetch-provider 边界路由，而非 Firecrawl-only 核心分支
• 迁移：
  使用 openclaw doctor --fix 迁移旧配置
• 影响：
  使用 Firecrawl web fetch 的用户需要更新配置

✨ 核心新增功能（10+ 项）

🔄 任务流系统（Task Flow）重大升级

1. Tasks/Task Flow — 核心任务流基板恢复

• 恢复核心 Task Flow 基板
• 支持托管（managed）与镜像（mirrored）同步模式
• 持久化流状态/修订跟踪
• 新增 openclaw flows 检查/恢复原语
• 后台编排可持久化并独立于插件编写层操作

2. Tasks/Task Flow — 托管子任务生成

• 添加托管子任务生成能力
• 支持粘性取消意图（sticky cancel intent）
• 外部编排器可立即停止调度
• 父 Task Flow 在活动子任务完成后优雅取消

3. Plugins/Task Flow — 绑定 API 运行时 seam

• 添加绑定的 api.runtime.taskFlow seam
• 插件和受信任的编写层可从主机解析的 OpenClaw 上下文创建和驱动托管 Task Flow
• 无需在每次调用时传递所有者标识符

📱 Android 与渠道集成

4. Android/assistant — Google Assistant App Actions

• 添加助手角色入口点
• 添加 Google Assistant App Actions 元数据
• Android 可从助手触发器启动 OpenClaw
• 支持将提示传递到聊天编辑器

5. Feishu/comments — 飞书文档评论增强

• 添加专用的 Drive 评论事件流
• 评论线程上下文解析
• 线程内回复支持
• feishu_drive
   评论操作
• 增强飞书文档协作工作流

6. Matrix/plugin — 合规提及元数据

• 在文本发送、媒体标题、编辑、投票回退文本和操作驱动编辑中发出符合规范的 m.mentions 元数据
• Matrix 提及在 Element 等客户端中可靠通知

🔧 其他功能

• 7. Exec defaults — YOLO 模式默认
  ：网关/节点主机 exec 默认使用 YOLO 模式，请求 security=full 且 ask=off，主机批准文件回退和文档/doctor 报告与此无提示默认对齐
• 8. Providers/runtime — 提供者重播钩子
  ：添加提供者拥有的重播钩子表面，支持转录策略、重播清理和推理模式调度
• 9. Plugins/hooks — before_agent_reply 钩子
  ：添加 before_agent_reply 钩子，插件可在内联操作后使用合成回复短路 LLM
• 10. Channels/session routing — 会话路由改进
  ：将提供者特定的会话对话语法移入插件拥有的 session-key 表面，保留 Telegram 主题路由和 Feishu 范围继承，跨 bootstrap、模型覆盖、重启和工具策略路径保持一致
• 11. Diffs — viewerBaseUrl 支持
  ：添加插件拥有的 viewerBaseUrl，查看器链接可使用稳定的代理/公共源，无需在每次工具调用时传递 baseUrl
• 12. Agents/compaction — 压缩模型解析修复
  ：为手动 /compact 和其他上下文引擎压缩路径一致解析 agents.defaults.compaction.model，添加 agents.defaults.compaction.notifyUser 使 "🧹 Compacting context..." 开始通知变为可选
• 13. WhatsApp/reactions — 表情反应指导
  ：添加 reactionLevel 指导用于 agent 表情反应
• 14. Exec approvals/channels — 原生聊天批准自动启用
  ：当支持的渠道可从现有所有者配置推断批准者时，自动启用 DM-first 原生聊天批准，保持渠道 fanout 显式，澄清转发与原生批准客户端配置

🐛 重要修复（25+ 项）

🌐 提供者/传输层修复

• Providers/transport policy — 请求策略集中化
  ：在共享 HTTP、流和 WebSocket 路径中集中请求认证、代理、TLS 和头部整形，阻止不安全的 TLS/运行时传输覆盖，保持代理跳 TLS 与目标 mTLS 设置分离
• Providers/Copilot — GitHub Copilot API 主机分类
  ：在共享提供者端点解析器中分类原生 GitHub Copilot API 主机，强化令牌派生代理端点解析，Copilot 基础 URL 路由保持集中化，在格式错误的提示上失败关闭
• Providers/streaming headers — 默认和归因头部合并
  ：在 OpenAI WebSocket、嵌入式运行器和代理流路径中集中默认和归因头部合并，提供者特定头部保持一致，调用者覆盖仅在预期位置生效
• Providers/media HTTP — 基础 URL 规范化
  ：在共享 OpenAI 兼容音频、Deepgram 音频、Gemini 媒体/图像和 Moonshot 视频请求路径中集中基础 URL 规范化、默认认证/头部注入和显式头部覆盖处理
• Providers/OpenAI-compatible routing — 原生 vs 代理请求策略
  ：集中原生 vs 代理请求策略，隐藏归因和相关 OpenAI 家族默认值仅适用于验证的原生端点
• Providers/Anthropic routing — 端点分类
  ：为直接 Anthropic service_tier 处理集中原生 vs 代理端点分类，欺骗或代理主机不继承原生 Anthropic 默认值

🖥️ 网关与执行修复

• Gateway/exec loopback — 传统角色回退恢复
  ：为空的配对设备令牌映射恢复传统角色回退，允许静默本地角色升级，本地 exec 和节点客户端在 2026.3.31 后停止因 "pairing-required" 错误而失败
• Agents/subagents — 子代理网关调用修复
  ：将仅限管理员的子代理网关调用固定到 operator.admin，保持 agent 至少特权，sessions_spawn 不再在循环回范围升级配对时因 close(1008) "pairing required" 而死亡
• Exec approvals/config — 无效值清理
  ：在规范化期间从 ~/.openclaw/exec-approvals.json 剥离无效的 security、ask 和 askFallback 值，格式错误的策略枚举干净地回退到记录的默认值
• Exec approvals/doctor — 主机策略源报告
  ：从真实的批准文件路径报告主机策略源，在归因有效策略冲突时忽略格式错误的主机覆盖值
• Exec/runtime — host=auto 路由修复
  ：将 tools.exec.host=auto 视为仅路由，当可用时保持隐式无配置 exec 在沙盒上，否则在网关上，拒绝会绕过配置的沙盒或主机目标的每调用主机覆盖

💬 渠道修复

• Slack/mrkdwn formatting — 内置格式指导
  ：添加入站上下文的内置 Slack mrkdwn 指导，Slack 回复不再回退到在 Slack 中渲染不佳的通用 Markdown 模式
• WhatsApp/presence — 推送通知修复
  ：在自聊模式下连接时发送不可用状态，个人手机用户在网关运行时不再丢失所有推送通知
• WhatsApp/media — MIME 类型支持
  ：将 HTML、XML 和 CSS 添加到 MIME 映射，对未知媒体类型优雅回退
• Matrix/onboarding — 引导设置恢复
  ：在 openclaw channels add 和 openclaw configure --section channels 中恢复引导设置，在共享 setupWizard seam 上保持自定义插件向导
• Matrix/streaming — 流式预览修复
  ：当启用 channels.matrix.blockStreaming 时，为当前助手块保持实时部分预览，将完成的块更新作为单独消息保留
• Feishu/comment threads — 文档评论线程强化
  ：强化文档评论线程传递，全文评论回退到 add_comment，延迟回复查找更可靠地重试，用户可见回复避免推理/规划溢出
• MS Teams/streaming — 重复内容修复
  ：当回复超过 4000 字符流式限制时，从回退块传递中剥离已流式文本，长响应不再重复内容
• Slack/thread context — 线程上下文过滤
  ：通过有效对话允许列表过滤线程启动器和历史记录，不丢失有效的开放房间、DM 或群组 DM 上下文
• Mattermost/probes — SSRF 防护路由
  ：通过 SSRF 防护路由状态探测，遵守 allowPrivateNetwork，自托管 Mattermost 部署的连接检查保持安全
• Zalo/webhook replay — 重播去重键范围
  ：按聊天和发送者范围重播去重键，不同聊天或发送者之间重用的消息 ID 不再冲突，强化部分缺失负载的元数据读取
• QQBot/structured payloads — 本地文件路径限制
  ：将本地文件路径限制为 QQ Bot 拥有的媒体存储，阻止该根目录外的遍历，减少日志中的路径泄露，保持内联图像数据 URL 工作

🎨 图像生成修复

• Image generation/providers — 共享 HTTP 传输路径
  ：通过共享提供者 HTTP 传输路径路由 OpenAI、MiniMax 和 fal 图像请求，自定义基础 URL、受保护的私有网络路由和提供者请求默认值与提供者 HTTP 其余部分保持一致
• Image generation/providers — 私有网络访问推断停止
  ：停止从配置的 OpenAI、MiniMax 和 fal 图像基础 URL 推断私有网络访问，限制共享 HTTP 错误主体读取，敌对或配置错误的端点在不放松 SSRF 策略或缓冲无界错误负载的情况下失败关闭

🌐 浏览器修复

• Browser/host inspection — 静态检查器隔离
  ：将静态 Chrome 检查助手保持在激活的浏览器运行时之外，openclaw doctor browser 和相关检查不再急切加载捆绑的浏览器插件
• Browser/CDP — 尾部点本地主机规范化
  ：在环回检查之前规范化尾部点本地主机绝对形式主机，远程 CDP WebSocket URL 如 ws://localhost.:... 重写回环

📊 版本对比

🎉 用户体验改进

✅ Exec approvals — 终于不再反复索要授权了！

• 问题：
  之前的版本会反复弹出 /approve <ID> 批准请求，即使已经批准过的命令也会重复询问
• 修复：
  当允许的自动化被启用时，从有效主机回退策略解决孤立的 cron 无路由批准死胡同
• 效果：allow-always
   持久化为耐用的用户批准信任，修复远程 exec 的假批准超时和禁用状态
• Loki 体验：
  现在不会再被反复打扰索要授权了！🎊

"终于不用再看到 /approve 898df230 allow-once 了..." —— 来自真实用户的血泪反馈

💡 对 Hope 的启发

🌟 值得关注的功能

2. Task Flow 系统重大升级
    托管 vs 镜像同步模式，持久化流状态跟踪，openclaw flows 命令用于检查/恢复，适合复杂后台编排场景 
4. Android Google Assistant 集成
    可通过语音触发启动 OpenClaw，提升移动端用户体验 
6. 飞书文档评论增强
    评论线程上下文解析，线程内回复支持，适合文档协作场景 

⚠️ 升级注意事项

• xAI 搜索配置路径变更 → 运行 openclaw doctor --fix
• Firecrawl web_fetch 配置路径变更 → 运行 openclaw doctor --fix

✅ 建议行动

• 推荐升级
  ：修复多项关键问题，Task Flow 系统增强
• 升级前
  ：运行 openclaw doctor --fix 迁移配置
• 可探索
  ：openclaw flows 命令、Task Flow 编排

📎 相关链接

• GitHub Release:
   https://github.com/openclaw/openclaw/releases/tag/v2026.4.2 
• 完整 Changelog:
   https://github.com/openclaw/openclaw/compare/v2026.4.1...v2026.4.2 
• NPM 包:
   https://www.npmjs.com/package/openclaw/v/2026.4.2 

整理人：Hope

发布日期：2026-04-03 10:10

🦞 OpenClaw 社区