CLI commands
`openclaw tasks`
Überprüfen Sie dauerhafte Hintergrundaufgaben und den Task-Flow-Status. Ohne Unterbefehl
entspricht openclaw tasks dem Befehl openclaw tasks list.
Unter Hintergrundaufgaben finden Sie das Lebenszyklus- und Zustellungsmodell
sowie im Abschnitt tasks audit vollständige Beschreibungen der Befunde.
Verwendung
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>Stammoptionen
| Flag | Beschreibung |
|---|---|
--json |
Gibt JSON aus. |
--runtime <name> |
Filtert nach Art: subagent, acp, cron oder cli. |
--status <name> |
Filtert nach Status: queued, running, succeeded, failed, timed_out, cancelled oder lost. |
Unterbefehle
list
openclaw tasks list [--runtime <name>] [--status <name>] [--json]Listet verfolgte Hintergrundaufgaben auf, beginnend mit der neuesten.
show
openclaw tasks show <lookup> [--json]Zeigt eine Aufgabe anhand der Aufgaben-ID, Ausführungs-ID oder des Sitzungsschlüssels an.
notify
openclaw tasks notify <lookup> <done_only|state_changes|silent>Ändert die Benachrichtigungsrichtlinie für eine laufende Aufgabe.
cancel
openclaw tasks cancel <lookup>Bricht eine laufende Hintergrundaufgabe ab.
audit
openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]Zeigt veraltete, verlorene, bei der Zustellung fehlgeschlagene oder anderweitig inkonsistente Aufgaben- und
Task-Flow-Datensätze an. Bis cleanupAfter aufbewahrte verlorene Aufgaben führen zu Warnungen;
abgelaufene oder nicht mit einem Zeitstempel versehene verlorene Aufgaben führen zu Fehlern.
--code akzeptiert Aufgabencodes (stale_queued, stale_running, lost,
delivery_failed, missing_cleanup, inconsistent_timestamps) und Task-
Flow-Codes (restore_failed, stale_waiting, stale_blocked,
cancel_stuck, missing_linked_tasks, blocked_task_missing). Unter
Hintergrundaufgaben finden Sie Details zu Schweregrad und Auslöser für jeden
Code.
maintenance
openclaw tasks maintenance [--apply] [--json]Zeigt eine Vorschau der Abstimmung, Bereinigungsmarkierung, Entfernung und Bereinigung der Registrierung veralteter Cron-Ausführungssitzungen für Aufgaben und Task Flow an oder wendet diese Vorgänge an.
Für Cron-Aufgaben verwendet die Abstimmung persistierte Ausführungsprotokolle und den Auftragsstatus, bevor
eine alte aktive Aufgabe als lost markiert wird. Dadurch werden abgeschlossene Cron-Ausführungen nicht zu
falschen Prüfungsfehlern, nur weil der Laufzeitstatus des Gateway im Arbeitsspeicher nicht mehr vorhanden ist.
Die Offline-CLI-Prüfung ist für die prozesslokale Gruppe aktiver Cron-Aufträge des Gateway
nicht maßgeblich. CLI-Aufgaben mit einer Ausführungs-ID/Quell-ID werden als lost markiert, wenn
ihr aktiver Gateway-Ausführungskontext nicht mehr vorhanden ist, selbst wenn noch ein alter untergeordneter Sitzungsdatensatz
besteht.
Bei der Anwendung entfernt die Wartung außerdem cron:<jobId>:run:<uuid>-Sitzungsdatensätze
aus der Registrierung, die älter als 7 Tage sind. Aktuell laufende Cron-Aufträge bleiben dabei erhalten,
und Sitzungsdatensätze, die nicht zu Cron gehören, bleiben unverändert.
flow
openclaw tasks flow list [--status <name>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>Überprüft dauerhaften Task-Flow-Status im Aufgabenjournal oder bricht ihn ab.
flow list --status akzeptiert queued, running, waiting, blocked,
succeeded, failed, cancelled oder lost.
