CLI commands

`openclaw tasks`

Inspecteer duurzame achtergrondtaken en de TaskFlow-status. Zonder subopdracht is openclaw tasks gelijkwaardig aan openclaw tasks list.

Zie Achtergrondtaken voor het levenscyclus- en afleveringsmodel en de sectie tasks audit voor volledige beschrijvingen van bevindingen.

Gebruik

bash
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>

Hoofdopties

Vlag Beschrijving
--json Voer JSON uit.
--runtime <name> Filter op soort: subagent, acp, cron of cli.
--status <name> Filter op status: queued, running, succeeded, failed, timed_out, cancelled of lost.

Subopdrachten

list

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

Toont bijgehouden achtergrondtaken met de nieuwste eerst.

show

bash
openclaw tasks show <lookup> [--json]

Toont één taak op basis van taak-ID, uitvoerings-ID of sessiesleutel.

notify

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

Wijzigt het meldingsbeleid voor een actieve taak.

cancel

bash
openclaw tasks cancel <lookup>

Annuleert een actieve achtergrondtaak.

audit

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

Brengt verouderde, verloren, niet-afgeleverde of anderszins inconsistente taak- en TaskFlow-records aan het licht. Verloren taken die tot cleanupAfter worden bewaard, zijn waarschuwingen; verlopen of niet-gemarkeerde verloren taken zijn fouten.

--code accepteert taakcodes (stale_queued, stale_running, lost, delivery_failed, missing_cleanup, inconsistent_timestamps) en TaskFlow-codes (restore_failed, stale_waiting, stale_blocked, cancel_stuck, missing_linked_tasks, blocked_task_missing). Zie Achtergrondtaken voor details over de ernst en activeringsvoorwaarde per code.

maintenance

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

Toont een voorbeeld van of past afstemming, opschoningsmarkering en verwijdering van taken en TaskFlow toe, evenals het opschonen van het sessieregister voor verouderde cron-uitvoeringen.

Voor cron-taken gebruikt de afstemming opgeslagen uitvoeringslogboeken en taakstatussen voordat een oude actieve taak als lost wordt gemarkeerd, zodat voltooide cron-uitvoeringen geen onterechte auditfouten worden alleen omdat de runtime-status in het geheugen van de Gateway verdwenen is. Een offline CLI-audit is niet gezaghebbend voor de proceslokale verzameling actieve cron-taken van de Gateway. CLI-taken met een uitvoerings-ID/bron-ID worden als lost gemarkeerd wanneer hun actieve Gateway-uitvoeringscontext verdwenen is, zelfs als een oude onderliggende sessierij blijft bestaan.

Bij toepassing verwijdert onderhoud ook cron:<jobId>:run:<uuid>-sessieregisterrijen ouder dan 7 dagen, waarbij momenteel actieve cron-taken behouden blijven en sessierijen die niet bij cron horen ongewijzigd blijven.

flow

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

Inspecteert of annuleert duurzame TaskFlow-status onder het takenregister. flow list --status accepteert queued, running, waiting, blocked, succeeded, failed, cancelled of lost.

Gerelateerd

Was this useful?
On this page

On this page