Task Flow 是位於背景任務之上的流程編排基底。它會管理具備自身狀態、修訂追蹤與同步語義的持久多步驟流程，而個別任務仍然是分離工作的單位。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.
何時使用 Task Flow
當工作跨越多個循序或分支步驟，而且你需要在 Gateway 重新啟動後仍能持久追蹤進度時，請使用 Task Flow。對於單一背景操作，普通任務就已足夠。| 情境 | 使用方式 |
|---|---|
| 單一背景工作 | 普通任務 |
| 多步驟管線（A 接著 B 接著 C） | Task Flow（受管理） |
| 觀察外部建立的任務 | Task Flow（鏡像） |
| 一次性提醒 | Cron 作業 |
可靠的排程工作流程模式
對於市場情報簡報等週期性工作流程，請將排程、編排與可靠性檢查視為不同層級：- 使用排程任務處理時間安排。
- 當工作流程應建立在先前脈絡之上時，使用持久的 cron 工作階段。
- 使用 Lobster 處理確定性步驟、核准閘門與繼續權杖。
- 使用 Task Flow 追蹤跨越子任務、等待、重試與 Gateway 重新啟動的多步驟執行。
session:<id> 而不是 isolated。當每次執行都應從全新狀態開始，而且所有必要狀態都已明確寫在工作流程中時，請使用 isolated。
在工作流程內，將可靠性檢查放在 LLM 摘要步驟之前：
- 瀏覽器可用性與設定檔選擇，例如使用
openclaw取得受管理狀態，或在需要已登入的 Chrome 工作階段時使用user。請參閱瀏覽器。 - 每個來源的 API 憑證與配額。
- 必要端點的網路可達性。
- 已為代理啟用必要工具，例如
lobster、browser與llm-task。 - 已為 cron 設定失敗目的地，讓預檢失敗可見。請參閱排程任務。
sourceUrl、retrievedAt 與 asOf。當你需要在工作流程中加入經結構描述驗證的模型步驟時，請使用 LLM Task。
對於可重複使用的團隊或社群工作流程，請將 CLI、.lobster 檔案與任何設定說明封裝為 skill 或 plugin，並透過 ClawHub 發佈。除非 Plugin API 缺少所需的通用能力，否則請將工作流程專屬的防護規則保留在該套件中。
同步模式
受管理模式
Task Flow 擁有端到端生命週期。它會建立作為流程步驟的任務、推動它們完成，並自動推進流程狀態。 範例：每週報告流程會 (1) 收集資料、(2) 產生報告，並 (3) 交付報告。Task Flow 會將每個步驟建立為背景任務，等待完成，然後移至下一個步驟。鏡像模式
Task Flow 會觀察外部建立的任務，並在不接管任務建立權的情況下保持流程狀態同步。當任務來自 cron 作業、CLI 命令或其他來源，而你想以流程形式統一查看其進度時，這會很有用。 範例：三個彼此獨立的 cron 作業共同組成「早晨營運」例行工作。鏡像流程會追蹤它們的整體進度，但不控制它們何時或如何執行。持久狀態與修訂追蹤
每個流程都會持久保存自己的狀態並追蹤修訂，因此進度可在 Gateway 重新啟動後保留。當多個來源嘗試同時推進同一個流程時，修訂追蹤可啟用衝突偵測。 流程登錄使用 SQLite，並具備有界限的預寫式日誌維護，包括 定期與關機檢查點，因此長時間執行的 Gateway 不會保留 無界限的registry.sqlite-wal sidecar 檔案。
取消行為
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 檢查負責編排的流程。