CLI commands
`openclaw tasks`
Dauerhafte Hintergrundaufgaben und den Task Flow-Zustand prüfen. Ohne Unterbefehl
ist openclaw tasks gleichbedeutend mit openclaw tasks list.
Siehe Hintergrundaufgaben für das Lebenszyklus- und Zustellmodell.
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>Root-Optionen
--json: JSON ausgeben.--runtime <name>: Nach Art filtern:subagent,acp,cronodercli.--status <name>: Nach Status filtern:queued,running,succeeded,failed,timed_out,cancelledoderlost.
Unterbefehle
list
openclaw tasks list [--runtime <name>] [--status <name>] [--json]Listet erfasste Hintergrundaufgaben, neueste zuerst.
show
openclaw tasks show <lookup> [--json]Zeigt eine Aufgabe anhand von Aufgaben-ID, Run-ID oder Sitzungsschlüssel 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, zustellungsfehlgeschlagene oder anderweitig inkonsistente Aufgaben- und Task Flow-Datensätze an. Bis cleanupAfter aufbewahrte verlorene Aufgaben sind Warnungen; abgelaufene oder nicht gestempelte verlorene Aufgaben sind Fehler.
maintenance
openclaw tasks maintenance [--apply] [--json]Zeigt eine Vorschau der Aufgaben- und Task Flow-Abstimmung, Bereinigungsstempelung, Ausdünnung
und Bereinigung der Sitzungsregistrierung für veraltete Cron-Runs an oder wendet sie an.
Für Cron-Aufgaben verwendet die Abstimmung persistierte Run-Protokolle bzw. den Job-Zustand, bevor eine
alte aktive Aufgabe als lost markiert wird, sodass abgeschlossene Cron-Runs nicht zu falschen Audit-Fehlern werden,
nur weil der speicherinterne Gateway-Laufzeitstatus nicht mehr vorhanden ist. Offline-CLI-Audit ist
nicht maßgeblich für die prozesslokale aktive Cron-Job-Menge des Gateway. CLI-Aufgaben
mit Run-ID/Quell-ID werden als lost markiert, wenn ihr Live-Gateway-Run-Kontext
nicht mehr vorhanden ist, selbst wenn eine alte Kind-Sitzungszeile bestehen bleibt.
Bei Anwendung entfernt die Wartung außerdem Sitzungsregistrierungszeilen der Form cron:<jobId>:run:<uuid>,
die älter als 7 Tage sind, bewahrt dabei aktuell laufende Cron-Jobs und lässt
Nicht-Cron-Sitzungszeilen 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 dauerhaften Task Flow-Zustand im Aufgaben-Ledger ab.