行业动态

OpenClaw 2026.3.31 版本深度解析 Task Flow 架构回归与执行策略重构

· 约 8 分钟阅读

OpenClaw 2026.3.31 版本深度解析:Task Flow 架构回归与执行策略重构

OpenClaw 发布 2026.3.31 版本,核心更新聚焦 Task Flow 任务流架构的完整回归,以及执行审批策略的层级重构。此次更新标志着该项目在背景任务编排能力上的重要里程碑。

Task Flow 架构的完整回归

OpenClaw 在此版本中正式恢复了核心的 Task Flow 底层架构。这一架构引入了托管(managed)与镜像(mirrored)两种同步模式,支持持久化的任务流状态追踪和版本修订记录。开发者可以通过 openclaw flows 命令族对后台编排任务进行状态检查和故障恢复操作。

托管模式的引入意味着外部编排器可以在停止任务调度后,让父级 Task Flow 等待所有活跃的子任务完成后再进入取消状态。这种设计避免了强制中断可能带来的数据不一致问题。同时,新增的托管子任务生成能力配合粘性取消意图(sticky cancel intent),为复杂工作流的优雅终止提供了机制保障。

插件层也获得了直接操作 Task Flow 的能力。通过绑定的 api.runtime.taskFlow 接口,插件和受信任的创作层可以在不传递所有者标识符的情况下,从主机解析的 OpenClaw 上下文中创建和管理托管任务流。这一变化降低了插件开发的复杂度,同时保持了架构的安全性边界。

执行审批策略的层级化重构

2026.3.31 版本对执行审批机制进行了深度重构,将原本相对简单的开关拆分为三个独立的控制层。这种分层设计解决了此前版本中常见的配置困惑——许多用户发现即使关闭了 Telegram 的审批开关,命令执行仍然会被拦截。

第一层是 Gateway 默认执行策略,通过 tools.exec 配置项控制,包含 securityask 两个关键参数。第二层是本机执行审批配置,存储在 ~/.openclaw/exec-approvals.json 文件中,决定了特定 Agent 在本机上的执行权限。第三层是会话级参数,通过 /exec 命令在特定聊天会话中临时覆盖全局配置。

版本更新后,Gateway 和节点主机的执行默认进入 YOLO 模式,即 security=full 配合 ask=off。这一变化意味着新安装实例将默认获得完全执行权限,减少了初次使用时的摩擦。但对于从旧版本升级的用户,需要手动同步三层配置才能确保行为一致。

插件配置路径的标准化迁移

此次更新包含两项破坏性变更,涉及 xAI 搜索插件和 Firecrawl 网页抓取插件的配置路径迁移。xAI 搜索的设置从传统的 tools.web.x_search. 核心路径迁移至插件专属的 plugins.entries.xai.config.xSearch. 路径,认证方式统一使用 plugins.entries.xai.config.webSearch.apiKey 或环境变量 XAI_API_KEY

Firecrawl 网页抓取配置同样从 tools.web.fetch.firecrawl. 核心路径迁移至 plugins.entries.firecrawl.config.webFetch.。网页抓取的后备逻辑也改为通过新的 fetch-provider 边界路由,而非之前的 Firecrawl 独占核心分支。开发者可以使用 openclaw doctor --fix 命令自动迁移遗留配置。

Android 平台与通信渠道的扩展

OpenClaw 在 Android 端新增了助手角色入口点和 Google Assistant App Actions 元数据支持。Android 用户现在可以通过助手触发器直接启动 OpenClaw,并将语音指令传递至聊天编辑器。这一集成让 OpenClaw 在移动端的可用性显著提升。

飞书渠道的文档协作能力得到增强,新增了专门的云文档评论事件流,支持评论线程上下文解析和线程内回复。Matrix 插件则完善了符合规范的 m.mentions 元数据发射,确保在 Element 等客户端中提及通知能够可靠送达。

提供商层的路由与安全加固

提供商层经历了大规模的安全加固和路由逻辑集中化。HTTP 传输策略现在统一处理认证、代理、TLS 和头部整形,阻止不安全的 TLS/运行时传输覆盖。GitHub Copilot API 主机被归类到共享提供商端点解析器中,基于令牌派生的代理端点解析也得到强化。

针对 OpenAI 兼容端点、Anthropic 端点的路由逻辑进行了集中化处理,确保只有经过验证的原生端点才能继承提供商特定的默认行为。这种设计防止了伪造或代理主机意外获得原生服务的默认配置,提升了整体安全性。

Diff 查看器新增了插件所有的 viewerBaseUrl 配置,允许查看器链接使用稳定的代理/公共源,无需在每次工具调用时传递 baseUrl。Agent 上下文压缩功能现在能够一致地解析 agents.defaults.compaction.model,并新增了 agents.defaults.compaction.notifyUser 选项,让用户可以自主选择是否显示压缩开始通知。

分享到: QQ 微博