TaskFlow 是位於背景任務之上的流程編排基底。它會管理具有自身狀態、修訂追蹤與同步語義的持久多步驟流程，而個別任務仍是分離工作的單位。Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
何時使用 TaskFlow
當工作橫跨多個循序或分支步驟，且需要在 gateway 重新啟動後仍能持久追蹤進度時，請使用 TaskFlow。對於單一背景作業，普通的任務就已足夠。| 情境 | 使用方式 |
|---|---|
| 單一背景工作 | 普通任務 |
| 多步驟管線（A 接著 B 接著 C） | TaskFlow（受管理） |
| 觀察外部建立的任務 | TaskFlow（鏡像） |
| 一次性提醒 | Cron 工作 |
可靠的排程工作流程模式
對於市場情報簡報等週期性工作流程，請將排程、編排與可靠性檢查視為不同層次：- 使用排程任務處理時機。
- 當工作流程應該基於先前脈絡延續時，使用持久 cron 工作階段。
- 使用 Lobster 處理確定性步驟、核准關卡與續接權杖。
- 使用 TaskFlow 在子任務、等待、重試與 gateway 重新啟動之間追蹤多步驟執行。
session:<id> 而不是 isolated。當每次執行都應該從全新狀態開始，且所有必要狀態都已在工作流程中明確指定時，請使用 isolated。
在工作流程內，請將可靠性檢查放在 LLM 摘要步驟之前：
- 瀏覽器可用性與設定檔選擇，例如受管理狀態使用
openclaw，需要已登入的 Chrome 工作階段時使用user。請參閱瀏覽器。 - 每個來源的 API 認證與配額。
- 必要端點的網路可連線性。
- 已為 agent 啟用必要工具，例如
lobster、browser與llm-task。 - 已為 cron 設定失敗目的地，讓預檢失敗可見。請參閱排程任務。
sourceUrl、retrievedAt 與 asOf。當你需要在工作流程內使用經 schema 驗證的模型步驟時，請使用 LLM Task。
對於可重複使用的團隊或社群工作流程，請將 CLI、.lobster 檔案與任何設定說明封裝為 skill 或 plugin，並透過 ClawHub 發布。除非 plugin API 缺少必要的通用能力，否則請將工作流程特定的防護規則保留在該套件中。
同步模式
受管理模式
TaskFlow 端到端擁有生命週期。它會建立任務作為流程步驟、驅動它們完成，並自動推進流程狀態。 範例：每週報告流程會 (1) 收集資料、(2) 產生報告，並 (3) 傳送報告。TaskFlow 會將每個步驟建立為背景任務，等待完成，然後移至下一個步驟。鏡像模式
TaskFlow 會觀察外部建立的任務，並在不取得任務建立所有權的情況下讓流程狀態保持同步。當任務來自 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 檢查編排流程。