Automation
任務流程
任務流程是位於背景任務之上的協調層。流程是多步驟工作的持久記錄，具有自己的狀態、JSON 狀態資料、修訂計數器，以及連結的任務記錄。流程可在閘道重新啟動後繼續存在；個別任務仍是分離式工作的基本單位。
何時使用任務流程
| 情境 | 使用方式 |
|---|---|
| 單一背景工作 | 一般任務 |
| 由外掛程式碼驅動的多步驟管線 | 任務流程（受管理） |
| 分離式 ACP 或子代理程式生成 | 任務流程（鏡像，自動建立） |
| 一次性提醒 | 排程工作 |
同步模式
受管理模式
受管理流程具有控制器：外掛程式碼透過外掛執行階段的任務流程 API，以目標和必要的控制器 ID 建立流程，然後明確驅動該流程。
- 每個步驟都會以流程下建立的背景任務執行；流程的擁有者索引鍵和請求者來源會沿用至子任務。
- 控制器會推進流程，使其在
running、waiting和終止狀態之間轉換，並在流程記錄中儲存任意 JSON 步驟狀態。 - 每次變更都會傳入流程的預期修訂版本。過時的寫入會因修訂衝突而遭拒絕，而不會覆蓋較新的狀態。
- 一旦提出取消要求，系統便會拒絕新的子任務；當沒有任何子任務仍在執行時，流程會以
cancelled狀態結束。
範例：每週報告流程會依序：(1) 收集資料、(2) 產生報告，以及 (3) 傳送報告，每個步驟各使用一項背景任務：
流程：weekly-report 步驟 1：gather-data → 已建立任務 → succeeded 步驟 2：generate-report → 已建立任務 → succeeded 步驟 3：deliver → 已建立任務 → running鏡像模式
當分離式 ACP 或子代理程式執行開始時（工作階段範圍內且完成時可交付的任務），OpenClaw 會自動建立僅含一項任務的鏡像流程。流程記錄會鏡像其唯一的後端任務，包括狀態、目標和時間資訊，因此分離式生成無須控制器，即可獲得穩定的流程控制代碼，以供狀態查詢和重試介面使用。鏡像流程在命令列介面中顯示的同步模式為 task_mirrored。
流程狀態
| 狀態 | 意義 |
|---|---|
queued |
已建立，尚未開始推進 |
running |
流程正在積極推進 |
waiting |
受管理流程暫停於等待中繼資料（計時器、外部事件） |
blocked |
某個步驟已完成，但沒有可用結果；blockedTaskId／摘要會指出是哪個步驟 |
succeeded |
已成功完成 |
failed |
因發生錯誤而完成 |
cancelled |
已要求取消，且所有子任務均已結束 |
lost |
流程遺失其具權威性的後端狀態 |
持久狀態與修訂追蹤
流程記錄會與任務記錄一同保存在共用 SQLite 狀態資料庫（~/.openclaw/state/openclaw.sqlite 的 flow_runs 資料表）中，因此進度可在閘道重新啟動後繼續保留。每次寫入都會遞增流程的 revision；並行寫入者若傳入過時的預期修訂版本，便會收到衝突，且必須重新讀取。SQLite 自動檢查點及定期被動檢查點會限制 WAL 的增長，關閉時則會執行截斷檢查點。舊版安裝中的傳統 flows/registry.sqlite 附屬資料庫會由 openclaw doctor 匯入。
取消行為
openclaw tasks flow cancel 會在流程上設定持續有效的取消意圖、取消其執行中的子任務，並拒絕新的受管理子任務。當沒有任何子任務仍在執行時，流程會以 cancelled 狀態結束；可能立即結束，也可能在子任務需要較長時間才能終止時，由維護掃描完成。此意圖會持久保存，因此即使閘道在所有子任務終止前重新啟動，已取消的流程仍會保持取消狀態。
命令列介面指令
# 列出執行中和最近的流程openclaw tasks flow list [--status <status>] [--json] # 顯示特定流程的詳細資料openclaw tasks flow show <lookup> [--json] # 取消執行中的流程及其執行中任務openclaw tasks flow cancel <lookup>| 指令 | 說明 |
|---|---|
openclaw tasks flow list |
顯示追蹤中的流程及其同步模式、狀態、修訂版本、控制器和任務數量 |
openclaw tasks flow show <id> |
依流程 ID 或擁有者索引鍵檢查單一流程，包括連結的任務 |
openclaw tasks flow cancel <id> |
取消執行中的流程及其執行中任務 |
openclaw tasks audit（過時或損壞的流程發現項目）和 openclaw tasks maintenance（完成卡住的取消作業，並在 7 天後清除已終止的流程）也涵蓋流程。
可靠的排程工作流程模式
對於市場情報簡報等週期性工作流程，請將排程、協調和可靠性檢查視為不同層級：
- 使用排程任務控制執行時間。
- 當工作流程應建立在先前的上下文上時，使用持久的排程工作階段。
- 使用 Lobster處理確定性步驟、核准閘門和繼續執行權杖。
- 使用任務流程追蹤跨越子任務、等待、重試和閘道重新啟動的多步驟執行。
排程形式範例：
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 session:<id>，而非 isolated。當每次執行都應從全新狀態開始，且所有必要狀態皆已在工作流程中明確指定時，請使用 isolated。
在工作流程內，請將可靠性檢查放在大型語言模型摘要步驟之前：
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。 - 已為排程設定失敗目的地，使前置檢查失敗可被看見。請參閱排程任務。
建議為每個收集項目提供下列資料來源欄位：
{ "sourceUrl": "https://example.com/report", "retrievedAt": "2026-04-24T12:00:00Z", "asOf": "2026-04-24", "title": "Example report", "content": "..."}讓工作流程在摘要前拒絕過時項目或將其標記為過時。大型語言模型步驟應僅接收結構化 JSON，且應要求它在輸出中保留 sourceUrl、retrievedAt 和 asOf。當工作流程內需要經結構描述驗證的模型步驟時，請使用大型語言模型任務。
對於可供團隊或社群重複使用的工作流程，請將命令列介面、.lobster 檔案和任何設定說明封裝為技能或外掛，並透過 ClawHub 發布。除非外掛 API 缺少必要的通用功能，否則請將工作流程專用的防護措施保留在該套件中。
流程與任務的關係
流程負責協調任務，而非取代任務。單一流程在其存續期間可能驅動多項背景任務。使用 openclaw tasks 檢查個別任務記錄，並使用 openclaw tasks flow 檢查負責協調的流程。
