`openclaw tasks`

CLI reference for `openclaw tasks` (background task ledger and Task Flow state)

Inspect durable background tasks and Task Flow state. With no subcommand, openclaw tasks is equivalent to openclaw tasks list.

See [Background Tasks](/docs/openclaw-docs/automation/tasks for the lifecycle and delivery model.

Usage

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>

Root Options

  • --json: output JSON.
  • --runtime <name>: filter by kind: subagent, acp, cron, or cli.
  • --status <name>: filter by status: queued, running, succeeded, failed, timed_out, cancelled, or lost.

Subcommands

list

openclaw tasks list [--runtime <name>] [--status <name>] [--json]

Lists tracked background tasks newest first.

show

openclaw tasks show <lookup> [--json]

Shows one task by task ID, run ID, or session key.

notify

openclaw tasks notify <lookup> <done_only|state_changes|silent>

Changes the notification policy for a running task.

cancel

openclaw tasks cancel <lookup>

Cancels a running background task.

audit

openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]

Surfaces stale, lost, delivery-failed, or otherwise inconsistent task and Task Flow records. Lost tasks retained until cleanupAfter are warnings; expired or unstamped lost tasks are errors.

maintenance

openclaw tasks maintenance [--apply] [--json]

Previews or applies task and Task Flow reconciliation, cleanup stamping, and pruning. For cron tasks, reconciliation uses persisted run logs/job state before marking an old active task lost, so completed cron runs do not become false audit errors just because the in-memory Gateway runtime state is gone. Offline CLI audit is not authoritative for the Gateway's process-local cron active-job set. CLI tasks with a run id/source id are marked lost when their live Gateway run context is gone, even if an old child-session row remains.

flow

openclaw tasks flow list [--status <name>] [--json]
openclaw tasks flow show <lookup> [--json]
openclaw tasks flow cancel <lookup>

Inspects or cancels durable Task Flow state under the task ledger.

  • [CLI reference](/docs/openclaw-docs/cli
  • [Background tasks](/docs/openclaw-docs/automation/tasks