`openclaw tasks`

檢查持久的背景工作和任務流程狀態。如果不指定子命令， openclaw tasks 等同於 openclaw tasks list。

請參閱 Background Tasks 以了解生命週期和傳遞模型。

用法

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]

顯示過期、遺失、傳遞失敗或其他不一致的工作和任務流程記錄。保留至 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>

檢查或取消工作帳本下的持久任務流程狀態。

相關

• CLI 參考資料
• 背景任務