使用 Task Flow 的時機
同步模式
受管理模式
受管理流程具有控制器：外掛程式碼透過外掛執行階段的 Task Flow API 建立流程，提供目標及必要的控制器 ID，然後明確驅動該流程。- 每個步驟都會以流程下建立的背景任務執行；流程的擁有者金鑰與請求者來源會沿用至子任務。
- 控制器會在
running、waiting與終止狀態之間推進流程，並將任意 JSON 步驟狀態儲存在流程記錄中。 - 每次變更都會傳入流程的預期修訂版。過時的寫入會因修訂衝突而遭拒，而不會覆寫較新的狀態。
- 一旦請求取消，系統便會拒絕新的子任務；當沒有任何子任務仍處於活動狀態時，流程會以
cancelled結束。
鏡像模式
當分離式 ACP 或子代理執行開始時（具有可傳遞完成結果的工作階段範圍任務），OpenClaw 會自動建立鏡像的單任務流程。流程記錄會鏡像其唯一的支援任務，包括狀態、目標與時間資訊，因此分離式啟動不需要控制器，也能取得穩定的流程控制代碼，用於狀態與重試介面。鏡像流程在命令列介面中會顯示同步模式task_mirrored。
流程狀態
持久狀態與修訂追蹤
流程記錄會與任務記錄一起持久儲存在共用 SQLite 狀態資料庫（~/.openclaw/state/openclaw.sqlite、flow_runs 資料表）中，因此進度可在閘道重新啟動後繼續保留。每次寫入都會遞增流程的 revision；並行寫入者若傳入過時的預期修訂版，將收到衝突並必須重新讀取。WAL 的成長會由 SQLite 自動檢查點及定期的被動檢查點限制，關閉時則會執行截斷檢查點。舊版安裝中的舊式 flows/registry.sqlite 附屬檔案會由 openclaw doctor 匯入。
取消行為
openclaw tasks flow cancel 會在流程上設定持續有效的取消意圖、取消其活動中的子任務，並拒絕新的受管理子任務。當沒有任何子任務仍處於活動狀態時，流程會以 cancelled 結束；可能立即結束，也可能在子任務需要較長時間才能結束時，由維護掃描完成。此意圖會持久儲存，因此即使閘道在所有子任務終止前重新啟動，已取消的流程仍會維持取消狀態。
命令列介面命令
openclaw tasks audit（過時或損壞的流程問題）與 openclaw tasks maintenance（完成卡住的取消作業，並在 7 天後清除終止流程）也會涵蓋流程。
可靠的排程工作流程模式
對於市場情報摘要等週期性工作流程，應將排程、協調與可靠性檢查視為不同層級：- 使用排程任務控制執行時間。
- 當工作流程應延續先前的內容脈絡時，使用持久的排程工作階段。
- 使用 Lobster 處理確定性步驟、核准關卡及繼續權杖。
- 使用 Task Flow 跨子任務、等待、重試及閘道重新啟動來追蹤多步驟執行。
--session session:<id>，而非 isolated。當每次執行都應從全新狀態開始，且工作流程中已明確提供所有必要狀態時，請使用 isolated。
在工作流程內，請將可靠性檢查置於 LLM 摘要步驟之前：
- 瀏覽器可用性與設定檔選擇，例如使用
openclaw處理受管理狀態，或在需要已登入的 Chrome 工作階段時使用user。請參閱瀏覽器。 - 每個來源的 API 認證資訊與配額。
- 必要端點的網路連線能力。
- 代理已啟用的必要工具，例如
lobster、browser及llm-task。 - 已為排程設定失敗目的地，以便查看預先檢查失敗。請參閱排程任務。
sourceUrl、retrievedAt 及 asOf。當工作流程內需要經結構描述驗證的模型步驟時，請使用 LLM 任務。
對於可供團隊或社群重複使用的工作流程，請將命令列介面、.lobster 檔案及任何設定說明封裝為 Skill 或外掛，並透過 ClawHub 發布。除非外掛 API 缺少必要的通用能力，否則請將工作流程特定的防護措施保留在該套件中。
流程與任務的關係
流程負責協調任務，而非取代任務。單一流程在其生命週期中可以驅動多個背景任務。使用openclaw tasks 檢查個別任務記錄，並使用 openclaw tasks flow 檢查負責協調的流程。