OpenClaw 2026.4.2 Release Notes

OpenClaw 2026.4.2 Release Notes

OpenClaw Changelog

2026.4.2

Breaking

  • Plugins/xAI: movexi>searchsettings from the legacy coretools.web.x/i>search.i>path to the plugin-ownedplugins.entries.xai.config.xSearch./i>path, standardizexi>searchauth onplugins.entries.xai.config.webSearch.apiKey/XAI/i>API_KEY, and migrate legacy config withopenclaw doctor --fix. (#59674) Thanks @vincentkoc.
  • Plugins/web fetch: move Firecrawlwebi>fetchconfig from the legacy coretools.web.fetch.firecrawl.i>path to the plugin-ownedplugins.entries.firecrawl.config.webFetch./i>path, routeweb/i>fetchfallback through the new fetch-provider boundary instead of a Firecrawl-only core branch, and migrate legacy config withopenclaw doctor --fix. (#59465) Thanks @vincentkoc.

Changes

  • Tasks/Task Flow: restore the core Task Flow substrate with managed-vs-mirrored sync modes, durable flow state/revision tracking, andopenclaw tasks flowinspection/recovery primitives so background orchestration can persist and be operated separately from plugin authoring layers. (#58930) Thanks @mbelinky.
  • Tasks/Task Flow: add managed child task spawning plus sticky cancel intent, so external orchestrators can stop scheduling immediately and let parent Task Flows settle tocancelledonce active child tasks finish. (#59610) Thanks @mbelinky.
  • Plugins/Task Flow: add a boundapi.runtime.taskFlowseam so plugins and trusted authoring layers can create and drive managed Task Flows from host-resolved OpenClaw context without passing owner identifiers on each call. (#59622) Thanks @mbelinky.
  • Android/assistant: add assistant-role entrypoints plus Google Assistant App Actions metadata so Android can launch OpenClaw from the assistant trigger and hand prompts into the chat composer. (#59596) Thanks @obviyus.
  • Exec defaults: make gateway/node host exec default to YOLO mode by requestingsecurity=fullwithask=off, and align host approval-file fallbacks plus docs/doctor reporting with that no-prompt default.
  • Providers/runtime: add provider-owned replay hook surfaces for transcript policy, replay cleanup, and reasoning-mode dispatch. (#59143) Thanks @jalehman.
  • Plugins/hooks: addbeforeagentreplyso plugins can short-circuit the LLM with synthetic replies after inline actions. (#20067) Thanks @JoshuaLelon.
  • Channels/session routing: move provider-specific session conversation grammar into plugin-owned session-key surfaces, preserving Telegram topic routing and Feishu scoped inheritance across bootstrap, model override, restart, and tool-policy paths.
  • Feishu/comments: add a dedicated Drive comment-event flow with comment-thread context resolution, in-thread replies, andfeishu_drivecomment actions for document collaboration workflows. (#58497) Thanks @wittam-01.
  • Matrix/plugin: emit spec-compliantm.mentionsmetadata across text sends, media captions, edits, poll fallback text, and action-driven edits so Matrix mentions notify reliably in clients like Element. (#59323) Thanks @gumadeiras.
  • Diffs: add plugin-ownedviewerBaseUrlso viewer links can use a stable proxy/public origin without passingbaseUrlon every tool call. (#59341) Related #59227. Thanks @gumadeiras.
  • Agents/compaction: resolveagents.defaults.compaction.modelconsistently for manual/compactand other context-engine compaction paths, so engine-owned compaction uses the configured override model across runtime entrypoints. (#56710) Thanks @oliviareid-svg.
  • Agents/compaction: addagents.defaults.compaction.notifyUserso the🧹 Compacting context...start notice is opt-in instead of always being shown. (#54251) Thanks @oguricap0327.
  • WhatsApp/reactions: addreactionLevelguidance for agent reactions. Thanks @mcaxtr.
  • Exec approvals/channels: auto-enable DM-first native chat approvals when supported channels can infer approvers from existing owner config, while keeping channel fanout explicit and clarifying forwarding versus native approval client config.
  • Android/assistant: auto-send Google Assistant App Actions prompts once chat is healthy and idle, while keeping bare assistant launches as open-only. (#59721) Thanks @obviyus.

Fixes

  • Sandbox/security: block credential-path binds even when sandbox home paths resolve through canonical aliases, so agent containers cannot mount user secret stores through alternate home-directory paths. (#59157) Thanks @eleqtrizit.
  • Gateway/Windows scheduled tasks: preserve Task Scheduler settings on reinstall, fail loud when Scheduled Task/Rundoes not start, and report fast failed restarts with the actual elapsed time instead of a fake 60s timeout. (#59335) Thanks @tmimmanuel.
  • Control UI/model picker: preserve already-qualifiedprovider/modelrefs from the server so models whose ids already contain slashes stop being double-prefixed and remapped to the wrong provider. (#49874) Thanks @ShionEria.
  • Models/selection: resolve bare model ids in session model switches against the configured allowlist before falling back to the current session provider, so Control UI model picks stop drifting intogoogle/k2p5and similar wrong-provider refs. (#51580) Thanks @honwee.

2026.4.2

Breaking

  • Plugins/xAI: 将xi>search设置从旧的核心路径tools.web.x/i>search.i>移动到插件所属路径plugins.entries.xai.config.xSearch./i>,标准化xi>search认证至plugins.entries.xai.config.webSearch.apiKey/XAI/i>API_KEY,并使用openclaw doctor --fix迁移旧配置。 (#59674) 感谢 @vincentkoc。
  • Plugins/web fetch: 将 Firecrawlwebi>fetch配置从旧的核心路径tools.web.fetch.firecrawl.i>移动到插件所属路径plugins.entries.firecrawl.config.webFetch./i>,通过新的 fetch-provider 边界路由web/i>fetch回退,而非仅限 Firecrawl 的核心分支,并使用openclaw doctor --fix迁移旧配置。 (#59465) 感谢 @vincentkoc。

Changes

  • Tasks/Task Flow: 恢复具有托管与镜像同步模式、持久化 flow 状态/修订跟踪以及openclaw tasks flow检查/恢复原语的核心 Task Flow 基底层,以便后台编排可以持久化并独立于插件编写层进行操作。 (#58930) 感谢 @mbelinky。
  • Tasks/Task Flow: 添加托管子任务生成及粘性取消意图,使外部编排器可以立即停止调度,并在活动子任务完成后让父级 Task Flows 稳定至cancelled状态。 (#59610) 感谢 @mbelinky。
  • Plugins/Task Flow: 添加绑定的api.runtime.taskFlow接口,使插件和受信任的编写层可以从主机解析的 OpenClaw 上下文创建并驱动托管的 Task Flows,而无需在每次调用时传递所有者标识符。 (#59622) 感谢 @mbelinky。
  • Android/assistant: 添加 assistant-role 入口点及 Google Assistant App Actions 元数据,使 Android 可以从 assistant 触发器启动 OpenClaw 并将 Prompt 传递至聊天编辑器。 (#59596) 感谢 @obviyus。
  • Exec defaults: 将 gateway/node 主机 exec 默认设置为 YOLO 模式(通过请求security=fullask=off),并使主机审批文件回退、文档及 doctor 报告与该无 Prompt 默认值保持一致。
  • Providers/runtime: 为 Transcript 策略、回放清理和 reasoning-mode 调度添加提供者所属的重放 Hook 表面。 (#59143) 感谢 @jalehman。
  • Plugins/hooks: 添加beforeagentreply,使插件可以在内联操作后通过合成回复短路 LLM。 (#20067) 感谢 @JoshuaLelon。
  • Channels/session routing: 将特定于提供者的会话对话语法移动到插件所属的会话密钥表面,在引导、模型覆盖、重启和工具策略路径中保留 Telegram 话题路由和飞书作用域继承。
  • Feishu/comments: 添加专用的云文档评论事件流,具备评论线程上下文解析、线程内回复以及用于文档协作工作流的feishu_drive评论操作。 (#58497) 感谢 @wittam-01。
  • Matrix/plugin: 在文本发送、媒体说明、编辑、投票回退文本和操作驱动的编辑中发出符合规范的m.mentions元数据,以便 Matrix 提及在 Element 等客户端中可靠地通知。 (#59323) 感谢 @gumadeiras。
  • Diffs: 添加插件所属的viewerBaseUrl,使查看器链接可以使用稳定的代理/公共源,而无需在每次工具调用时传递baseUrl。 (#59341) 相关 #59227。 感谢 @gumadeiras。
  • Agents/compaction: 为手动/compact和其他上下文引擎压缩路径一致地解析agents.defaults.compaction.model,使引擎所属的压缩在各运行时入口点使用配置的覆盖模型。 (#56710) 感谢 @oliviareid-svg。
  • Agents/compaction: 添加agents.defaults.compaction.notifyUser,使🧹 Compacting context...开始通知变为可选加入,而非始终显示。 (#54251) 感谢 @oguricap0327。
  • WhatsApp/reactions: 为 Agent 回应添加reactionLevel指导。 感谢 @mcaxtr。
  • Exec approvals/channels: 当支持的频道可以从现有所有者配置推断审批者时,自动启用私聊优先的内置聊天审批,同时保持频道扇出显式化,并澄清转发与内置审批客户端配置。
  • Android/assistant: 在聊天状态健康且空闲时自动发送 Google Assistant App Actions Prompt,同时保持纯 assistant 启动为仅打开。 (#59721) 感谢 @obviyus。

Fixes

  • Sandbox/security: 即使 Sandbox 主路径通过规范别名解析,也禁止绑定凭据路径,防止 Agent 容器通过替代的主目录路径挂载用户密钥库。 (#59157) 感谢 @eleqtrizit。
  • Gateway/Windows scheduled tasks: 在重新安装时保留任务计划程序设置,当计划任务/Run未启动时报错,并报告实际流逝的时间而非虚假的 60 秒超时来记录快速失败的重启。 (#59335) 感谢 @tmimmanuel。
  • Control UI/model picker: 保留来自服务器的已限定provider/model引用,使 ID 中已包含斜杠的模型停止被重复添加前缀并重映射到错误的提供者。 (#49874) 感谢 @ShionEria。
  • Models/selection: 在会话模型切换中,先根据配置的允许列表解析裸模型 ID,再回退到当前会话提供者,以防止 Control UI 模型选择漂移到google/k2p5及类似的错误提供者引用。 (#51580) 感谢 @honwee.

Report Page