跳轉到主要內容
檢查持久性背景任務與 Task Flow 狀態。沒有子命令時，openclaw tasks 等同於 openclaw tasks list。 請參閱 背景任務 了解生命週期與傳遞模型。

​
使用方式

openclaw tasks
openclaw tasks list
openclaw tasks list --runtime acp
openclaw tasks list --status running
openclaw tasks show <lookup>
openclaw tasks notify <lookup> state_changes
openclaw tasks cancel <lookup>
openclaw tasks audit
openclaw tasks maintenance
openclaw tasks maintenance --apply
openclaw tasks flow list
openclaw tasks flow show <lookup>
openclaw tasks flow cancel <lookup>

​
根選項

  • --json: 輸出 JSON。
  • --runtime <name>: 依類型篩選：subagent、acp、cron 或 cli。
  • --status <name>: 依狀態篩選：queued、running、succeeded、failed、timed_out、cancelled 或 lost。

​
子命令

​
list

openclaw tasks list [--runtime <name>] [--status <name>] [--json]
列出追蹤中的背景任務，最新的在前。

​
show

openclaw tasks show <lookup> [--json]
依任務 ID、執行 ID 或工作階段金鑰顯示單一任務。

​
notify

openclaw tasks notify <lookup> <done_only|state_changes|silent>
變更執行中任務的通知政策。

​
cancel

openclaw tasks cancel <lookup>
取消執行中的背景任務。

​
audit

openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]
顯示過期、遺失、傳遞失敗，或其他不一致的任務與 Task Flow 記錄。保留到 cleanupAfter 的遺失任務為警告；已過期或未蓋章的遺失任務為錯誤。

​
maintenance

openclaw tasks maintenance [--apply] [--json]
預覽或套用任務與 Task Flow 協調、清理蓋章、修剪， 以及過期的 Cron 執行工作階段登錄清理。 對於 Cron 任務，協調會先使用持久化的執行記錄/工作狀態，然後才將 舊的作用中任務標記為 lost，因此已完成的 Cron 執行不會只因記憶體中的 Gateway 執行階段狀態消失 就變成錯誤的稽核錯誤。離線 CLI 稽核對 Gateway 的程序本機 Cron 作用中工作集合 不具權威性。具有執行 ID/來源 ID 的 CLI 任務會在其即時 Gateway 執行內容 消失時標記為 lost，即使仍有舊的子工作階段資料列存在。 套用後，維護也會修剪早於 7 天的 cron:<jobId>:run:<uuid> 工作階段登錄 資料列，同時保留目前執行中的 Cron 工作，並讓 非 Cron 工作階段資料列保持不變。

​
flow

openclaw tasks flow list [--status <name>] [--json]
openclaw tasks flow show <lookup> [--json]
openclaw tasks flow cancel <lookup>
檢查或取消任務分類帳下的持久性 Task Flow 狀態。

​
相關