CLI commands
`openclaw tasks`
Inspectez les tâches d’arrière-plan durables et l’état de TaskFlow. Sans sous-commande,
openclaw tasks équivaut à openclaw tasks list.
Consultez Tâches d’arrière-plan pour le cycle de vie et le modèle
de livraison, ainsi que sa section tasks audit pour une description complète des constats.
Utilisation
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>Options racines
| Indicateur | Description |
|---|---|
--json |
Produit une sortie JSON. |
--runtime <name> |
Filtre par type : subagent, acp, cron ou cli. |
--status <name> |
Filtre par état : queued, running, succeeded, failed, timed_out, cancelled ou lost. |
Sous-commandes
list
openclaw tasks list [--runtime <name>] [--status <name>] [--json]Répertorie les tâches d’arrière-plan suivies, de la plus récente à la plus ancienne.
show
openclaw tasks show <lookup> [--json]Affiche une tâche à partir de son identifiant de tâche, de son identifiant d’exécution ou de sa clé de session.
notify
openclaw tasks notify <lookup> <done_only|state_changes|silent>Modifie la politique de notification d’une tâche en cours d’exécution.
cancel
openclaw tasks cancel <lookup>Annule une tâche d’arrière-plan en cours d’exécution.
audit
openclaw tasks audit [--severity <warn|error>] [--code <name>] [--limit <n>] [--json]Signale les enregistrements de tâches et de TaskFlow obsolètes, perdus, dont la livraison
a échoué ou présentant d’autres incohérences. Les tâches perdues conservées jusqu’à
cleanupAfter génèrent des avertissements ; les tâches perdues arrivées à expiration ou
sans horodatage génèrent des erreurs.
--code accepte les codes de tâche (stale_queued, stale_running, lost,
delivery_failed, missing_cleanup, inconsistent_timestamps) et les codes TaskFlow
(restore_failed, stale_waiting, stale_blocked, cancel_stuck,
missing_linked_tasks, blocked_task_missing). Consultez
Tâches d’arrière-plan pour connaître le niveau de gravité et les
conditions de déclenchement de chaque code.
maintenance
openclaw tasks maintenance [--apply] [--json]Prévisualise ou applique la réconciliation des tâches et de TaskFlow, l’ajout d’horodatages de nettoyage, l’élagage et le nettoyage du registre de sessions des exécutions Cron obsolètes.
Pour les tâches Cron, la réconciliation utilise les journaux d’exécution persistants et
l’état des tâches avant de marquer une ancienne tâche active comme lost, afin que les
exécutions Cron terminées ne deviennent pas de fausses erreurs d’audit simplement parce
que l’état d’exécution en mémoire du Gateway a disparu. L’audit CLI hors ligne ne fait
pas autorité pour l’ensemble local au processus des tâches Cron actives du Gateway. Les
tâches CLI dotées d’un identifiant d’exécution ou d’un identifiant source sont marquées
lost lorsque leur contexte d’exécution actif dans le Gateway a disparu, même si une
ancienne ligne de session enfant subsiste.
Lorsqu’elle est appliquée, la maintenance élague également les lignes du registre de
sessions cron:<jobId>:run:<uuid> datant de plus de 7 jours, tout en préservant les
tâches Cron actuellement en cours d’exécution et sans modifier les lignes de session
non liées à Cron.
flow
openclaw tasks flow list [--status <name>] [--json]openclaw tasks flow show <lookup> [--json]openclaw tasks flow cancel <lookup>Inspecte ou annule l’état durable de TaskFlow dans le registre des tâches.
flow list --status accepte queued, running, waiting, blocked,
succeeded, failed, cancelled ou lost.
