メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

永続的なバックグラウンドタスクと Task Flow の状態を調査します。サブコマンドを指定しない場合、 openclaw tasksopenclaw 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>: 種類でフィルタリングします: subagentacpcron、または cli
  • --status <name>: 状態でフィルタリングします: queuedrunningsucceededfailedtimed_outcancelled、または 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 まで保持される失われたタスクは警告です。期限切れまたはスタンプされていない失われたタスクはエラーです。

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 状態を調査またはキャンセルします。

関連