任务流是位于后台任务之上的流程编排基底。它管理带有自身状态、修订跟踪和同步语义的持久多步骤流程，而单个任务仍然是脱离式工作的单位。Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
何时使用任务流
当工作跨越多个顺序或分支步骤，并且你需要在 Gateway 网关重启后仍能持久跟踪进度时，使用任务流。对于单个后台操作，普通任务就足够了。| 场景 | 使用方式 |
|---|---|
| 单个后台作业 | 普通任务 |
| 多步骤流水线（A 然后 B 然后 C） | 任务流（托管） |
| 观察外部创建的任务 | 任务流（镜像） |
| 一次性提醒 | Cron 作业 |
可靠的定时工作流模式
对于市场情报简报等周期性工作流，将调度、编排和可靠性检查视为独立层：- 使用定时任务来控制时间。
- 当工作流应基于先前上下文继续构建时，使用持久 cron 会话。
- 使用 Lobster 处理确定性步骤、审批门禁和恢复令牌。
- 使用任务流跨子任务、等待、重试和 Gateway 网关重启来跟踪多步骤运行。
session:<id> 而不是 isolated。当每次运行都应从零开始，并且所有必需状态都在工作流中显式声明时，使用 isolated。
在工作流内部，将可靠性检查放在 LLM 摘要步骤之前：
- 浏览器可用性和配置文件选择，例如为托管状态使用
openclaw，或在需要已登录的 Chrome 会话时使用user。参见浏览器。 - 每个来源的 API 凭证和配额。
- 所需端点的网络可达性。
- 为智能体启用所需工具，例如
lobster、browser和llm-task。 - 为 cron 配置失败目标位置，以便预检失败可见。参见定时任务。
sourceUrl、retrievedAt 和 asOf。当你需要在工作流中使用经过模式验证的模型步骤时，使用 LLM 任务。
对于可复用的团队或社区工作流，将 CLI、.lobster 文件和任何设置说明打包为 skill 或插件，并通过 ClawHub 发布。除非插件 API 缺少所需的通用能力，否则将特定于工作流的防护规则保留在该包中。
同步模式
托管模式
任务流拥有端到端生命周期。它将任务创建为流程步骤，推动它们完成，并自动推进流程状态。 示例：一个每周报告流程会（1）收集数据，（2）生成报告，（3）交付报告。任务流将每个步骤创建为后台任务，等待完成，然后进入下一步。镜像模式
任务流观察外部创建的任务，并在不接管任务创建所有权的情况下保持流程状态同步。当任务来自 cron 作业、CLI 命令或其他来源，而你希望以流程形式统一查看它们的进度时，这很有用。 示例：三个独立的 cron 作业共同构成一个“早间运维”例程。镜像流程会跟踪它们的整体进度，但不控制它们何时或如何运行。持久状态和修订跟踪
每个流程都会持久化自身状态并跟踪修订，因此进度可以在 Gateway 网关重启后保留。修订跟踪支持在多个来源尝试并发推进同一流程时检测冲突。 流程注册表使用 SQLite，并带有有界的预写日志维护，包括 周期性检查点和关机检查点，因此长时间运行的 Gateway 网关不会保留 无界的registry.sqlite-wal 辅助文件。
取消行为
openclaw tasks flow cancel 会在流程上设置粘性取消意图。流程中的活动任务会被取消，并且不会启动新步骤。取消意图会跨重启保留，因此即使 Gateway 网关在所有子任务终止前重启，已取消的流程也会保持取消状态。
CLI 命令
| 命令 | 描述 |
|---|---|
openclaw tasks flow list | 显示带有状态和同步模式的已跟踪流程 |
openclaw tasks flow show <id> | 按流程 ID 或查找键检查一个流程 |
openclaw tasks flow cancel <id> | 取消正在运行的流程及其活动任务 |
流程与任务的关系
流程协调任务，而不是替代任务。单个流程在其生命周期中可能驱动多个后台任务。使用openclaw tasks 检查单个任务记录，使用 openclaw tasks flow 检查编排流程。