CLI commands
`openclaw tasks`
永続的なバックグラウンドタスクと Task Flow の状態を確認します。サブコマンドを指定しない場合、
openclaw tasks は openclaw tasks list と同等です。
ライフサイクルと配信モデルについては バックグラウンドタスクを、すべての検出結果の説明についてはその tasks audit セクションを参照してください。
使用方法
openclaw tasksopenclaw tasks listopenclaw tasks list --runtime acpopenclaw tasks list --status runningopenclaw tasks show <lookup>openclaw tasks notify <lookup> state_changesopenclaw tasks cancel <lookup>openclaw tasks auditopenclaw tasks maintenanceopenclaw tasks maintenance --applyopenclaw tasks flow listopenclaw 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、またはセッションキーを指定して、1 件のタスクを表示します。
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 まで保持される消失タスクは警告となり、
期限切れまたはスタンプのない消失タスクはエラーとなります。
--code には、タスクコード（stale_queued、stale_running、lost、
delivery_failed、missing_cleanup、inconsistent_timestamps）および Task
Flow コード（restore_failed、stale_waiting、stale_blocked、
cancel_stuck、missing_linked_tasks、blocked_task_missing）を指定できます。コードごとの重大度と
トリガーの詳細については、バックグラウンドタスクを参照してください。
maintenance
openclaw tasks maintenance [--apply] [--json]タスクと Task Flow の整合化、クリーンアップのスタンプ付与、 プルーニング、および古い Cron 実行セッションレジストリのクリーンアップをプレビューまたは適用します。
Cron タスクでは、古いアクティブタスクを lost としてマークする前に、
永続化された実行ログとジョブ状態を使用して整合化するため、メモリ内の Gateway ランタイム状態が
消失しただけで、完了済みの Cron 実行が誤って監査エラーになることはありません。
オフライン CLI 監査は、Gateway のプロセスローカルな Cron アクティブジョブセットに対する
信頼できる情報源ではありません。実行 ID／ソース ID を持つ CLI タスクは、古い子セッション行が
残っていても、稼働中の Gateway 実行コンテキストが消失すると lost としてマークされます。
適用した場合、メンテナンスは、現在実行中の Cron ジョブを保持し、Cron 以外のセッション行には
変更を加えずに、7 日より古い cron:<jobId>:run:<uuid> セッションレジストリ行もプルーニングします。
flow
openclaw tasks flow list [--status <name>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>タスク台帳にある永続的な Task Flow の状態を確認またはキャンセルします。
flow list --status には、queued、running、waiting、blocked、
succeeded、failed、cancelled、または lost を指定できます。
