CLI commands
`openclaw tasks`
Prüfen Sie dauerhafte Hintergrundaufgaben und den TaskFlow-Status. Ohne Unterbefehl
entspricht openclaw tasks dem Befehl openclaw tasks list.
Unter Hintergrundaufgaben finden Sie Informationen zum 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 Typ: 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 die verfolgten Hintergrundaufgaben auf, die neuesten zuerst.
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 TaskFlow-Einträge an. Verlorene Aufgaben, die bis cleanupAfter aufbewahrt werden,
gelten als Warnungen; abgelaufene oder nicht mit einem Zeitstempel versehene verlorene Aufgaben
gelten als Fehler.
--code akzeptiert Aufgabencodes (stale_queued, stale_running, lost,
delivery_failed, missing_cleanup, inconsistent_timestamps) und TaskFlow-Codes
(restore_failed, stale_waiting, stale_blocked, cancel_stuck,
missing_linked_tasks, blocked_task_missing). Unter
Hintergrundaufgaben finden Sie Einzelheiten zu Schweregrad und Auslöser
jedes Codes.
maintenance
openclaw tasks maintenance [--apply] [--json]Zeigt eine Vorschau der Abstimmung von Aufgaben und TaskFlow, der Kennzeichnung für die Bereinigung, der Bereinigung selbst sowie der Bereinigung veralteter Cron-Ausführungssitzungen in der Sitzungsregistrierung an oder wendet diese Vorgänge an.
Bei 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 fälschlicherweise als Überprüfungsfehler eingestuft,
nur weil der speicherinterne Laufzeitstatus des Gateway nicht mehr vorhanden ist. Eine
Offline-Überprüfung per CLI ist für die prozesslokale Menge aktiver Cron-Aufträge des Gateway
nicht maßgeblich. CLI-Aufgaben mit einer Ausführungs-ID oder Quell-ID werden als lost
markiert, wenn ihr aktiver Gateway-Ausführungskontext nicht mehr vorhanden ist, selbst wenn
noch ein alter Eintrag einer untergeordneten Sitzung existiert.
Bei der Anwendung entfernt die Wartung außerdem Einträge der Sitzungsregistrierung im Format
cron:<jobId>:run:<uuid>, die älter als sieben Tage sind. Aktuell laufende Cron-Aufträge
bleiben dabei erhalten, und Sitzungszeilen, 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>Prüft oder bricht den dauerhaften TaskFlow-Status im Aufgabenjournal ab.
flow list --status akzeptiert queued, running, waiting, blocked,
succeeded, failed, cancelled oder lost.
