快速开始

任务流程

任务流是位于后台任务之上的流程编排基底。它管理带有自身状态、修订跟踪和同步语义的持久多步骤流程，而单个任务仍然是脱离式工作的单位。

何时使用任务流

当工作跨越多个顺序或分支步骤，并且你需要在 Gateway 网关重启后仍能持久跟踪进度时，使用任务流。对于单个后台操作，普通任务就足够了。

场景	使用方式
单个后台作业	普通任务
多步骤流水线（A 然后 B 然后 C）	任务流（托管）
观察外部创建的任务	任务流（镜像）
一次性提醒	Cron 作业

可靠的定时工作流模式

对于市场情报简报等周期性工作流，将调度、编排和可靠性检查视为独立层：

使用定时任务来控制时间。
当工作流应基于先前上下文继续构建时，使用持久 cron 会话。
使用 Lobster 处理确定性步骤、审批门禁和恢复令牌。
使用任务流跨子任务、等待、重试和 Gateway 网关重启来跟踪多步骤运行。

示例 cron 形态：

bash

openclaw cron add \  --name "Market intelligence brief" \  --cron "0 7 * * 1-5" \  --tz "America/New_York" \  --session session:market-intel \  --message "Run the market-intel Lobster workflow. Verify source freshness before summarizing." \  --announce \  --channel slack \  --to "channel:C1234567890"

当周期性工作流需要有意保留历史、上次运行摘要或常驻上下文时，使用 session:<id> 而不是 isolated。当每次运行都应从零开始，并且所有必需状态都在工作流中显式声明时，使用 isolated。

在工作流内部，将可靠性检查放在 LLM 摘要步骤之前：

yaml

name: market-intel-briefsteps:  - id: preflight    command: market-intel check --json  - id: collect    command: market-intel collect --json    stdin: $preflight.json  - id: summarize    command: market-intel summarize --json    stdin: $collect.json  - id: approve    command: market-intel deliver --preview    stdin: $summarize.json    approval: required  - id: deliver    command: market-intel deliver --execute    stdin: $summarize.json    condition: $approve.approved

建议的预检检查：

浏览器可用性和配置文件选择，例如为托管状态使用 openclaw，或在需要已登录的 Chrome 会话时使用 user。参见浏览器。
每个来源的 API 凭证和配额。
所需端点的网络可达性。
为智能体启用所需工具，例如 lobster、browser 和 llm-task。
为 cron 配置失败目标位置，以便预检失败可见。参见定时任务。

每个收集项建议的数据来源字段：

json

{  "sourceUrl": "https://example.com/report",  "retrievedAt": "2026-04-24T12:00:00Z",  "asOf": "2026-04-24",  "title": "Example report",  "content": "..."}

让工作流在摘要生成前拒绝或标记过期项。LLM 步骤应仅接收结构化 JSON，并应要求它在输出中保留 sourceUrl、retrievedAt 和 asOf。当你需要在工作流中使用经过模式验证的模型步骤时，使用 LLM 任务。

对于可复用的团队或社区工作流，将 CLI、.lobster 文件和任何设置说明打包为 skill 或插件，并通过 ClawHub 发布。除非插件 API 缺少所需的通用能力，否则将特定于工作流的防护规则保留在该包中。

同步模式

托管模式

任务流拥有端到端生命周期。它将任务创建为流程步骤，推动它们完成，并自动推进流程状态。

示例：一个每周报告流程会（1）收集数据，（2）生成报告，（3）交付报告。任务流将每个步骤创建为后台任务，等待完成，然后进入下一步。

Code

Flow: weekly-report  Step 1: gather-data     → task created → succeeded  Step 2: generate-report → task created → succeeded  Step 3: deliver         → task created → running

镜像模式

任务流观察外部创建的任务，并在不接管任务创建所有权的情况下保持流程状态同步。当任务来自 cron 作业、CLI 命令或其他来源，而你希望以流程形式统一查看它们的进度时，这很有用。

示例：三个独立的 cron 作业共同构成一个“早间运维”例程。镜像流程会跟踪它们的整体进度，但不控制它们何时或如何运行。

持久状态和修订跟踪

每个流程都会持久化自身状态并跟踪修订，因此进度可以在 Gateway 网关重启后保留。修订跟踪支持在多个来源尝试并发推进同一流程时检测冲突。流程注册表使用 SQLite，并带有有界的预写日志维护，包括周期性检查点和关机检查点，因此长时间运行的 Gateway 网关不会保留无界的 registry.sqlite-wal 辅助文件。

取消行为

openclaw tasks flow cancel 会在流程上设置粘性取消意图。流程中的活动任务会被取消，并且不会启动新步骤。取消意图会跨重启保留，因此即使 Gateway 网关在所有子任务终止前重启，已取消的流程也会保持取消状态。

CLI 命令