何时使用 Task Flow
同步模式
托管模式
托管流有一个控制器：插件代码通过插件运行时 Task Flow API 创建该流，设置目标和必需的控制器 ID，然后显式驱动它。- 每个步骤都作为该流下创建的后台任务运行；该流的 owner key 和 requester origin 会传递给子任务。
- 控制器在
running、waiting和终态之间推进该流，并在流记录上存储任意 JSON 步骤状态。 - 每次变更都会带上该流期望的 revision。过期写入会被作为 revision 冲突拒绝，而不是覆盖较新的状态。
- 一旦请求取消，就会拒绝新的子任务；当不再有子任务处于活动状态时，该流会以
cancelled结束。
镜像模式
当一个 detached ACP 或 subagent 运行开始时，OpenClaw 会自动创建一个镜像的单任务流（带有可交付结果完成的 session 范围任务）。该流记录会镜像其唯一的底层任务——状态、目标和时间——因此 detached 启动会获得一个稳定的流句柄，用于状态和重试界面，而无需控制器。镜像流在 CLI 中显示同步模式task_mirrored。
流状态
持久化状态和修订跟踪
流程记录与任务记录一起持久化在共享的 SQLite 状态数据库（~/.openclaw/state/openclaw.sqlite，flow_runs 表）中，因此即使网关重启，进度也能继续保留。每次写入都会提升流程的 revision；通过传入过期的预期修订号进行并发写入时，会发生冲突，必须重新读取。WAL 增长由 SQLite 自动检查点机制加上定期的被动检查点共同限制，并在关闭时执行 truncate 检查点。旧版安装中的遗留 flows/registry.sqlite 辅助数据库会被 openclaw doctor 导入。
取消行为
openclaw tasks flow cancel 会在流程上设置一个持久化的取消意图，取消其正在运行的子任务，并拒绝新的受管子任务。只要不再有任何子任务处于活动状态，该流程就会最终变为 cancelled - 可能是立即完成，或者在子任务需要更长时间稳定下来时通过维护扫描完成。该意图会被持久化，因此即使网关在所有子任务终止之前重启，已取消的流程仍会保持为已取消状态。
CLI 命令
流程也包含在
openclaw tasks audit（陈旧或损坏的流程发现）和 openclaw tasks maintenance（完成卡住的取消操作，在 7 天后清理终态流程）中。
可靠的计划工作流模式
对于市场情报简报之类的重复工作流，请将计划、编排和可靠性检查视为独立层：- 使用 自动化 进行定时。
- 当工作流需要基于先前上下文继续运行时，使用持久化自动化会话。
- 使用 Lobster 执行确定性步骤、审批关卡和恢复令牌。
- 使用 Task Flow 跟踪跨子任务、等待、重试和网关重启的多步骤运行。
openclaw automations；openclaw cron 仍是别名）：
--session session:<id>，而不是 isolated。当每次运行都应从头开始，并且所有所需状态都在工作流中显式提供时，请使用 isolated。
在工作流内部，将可靠性检查放在 LLM 总结步骤之前：
- 浏览器可用性和配置文件选择，例如，对于托管状态使用
openclaw，或者在需要已登录 Chrome 会话时使用user。请参阅 浏览器。 - 每个来源的 API 凭据和配额。
- 所需端点的网络可达性。
- 为代理启用的必需工具，例如
lobster、browser和llm-task。 - 为自动化配置故障目标，以便能够发现 preflight 失败。请参阅 自动化。
sourceUrl、retrievedAt 和 asOf。当你需要在工作流中使用一个经过 schema 验证的模型步骤时，请使用 LLM Task。
用于可复用的团队或社区工作流时，请将 CLI、.lobster 文件以及任何设置说明打包为 skill 或 plugin，并通过 ClawHub 发布。除非插件 API 缺少所需的通用能力，否则应将工作流特定的护栏保留在该包中。
flows 与 tasks 的关系
flow 负责协调 task，而不是替代它们。单个 flow 在其生命周期内可以驱动多个后台任务。使用openclaw tasks 检查单个任务记录，使用 openclaw tasks flow 检查编排该任务的 flow。