Sur cette page
Sur cette page
Commencer
`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
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
Répertorie les tâches d’arrière-plan suivies, de la plus récente à la plus ancienne.
show
Affiche une tâche à partir de son identifiant de tâche, de son identifiant d’exécution ou de sa clé de session.
notify
Modifie la politique de notification d’une tâche en cours d’exécution.
cancel
Annule une tâche d’arrière-plan en cours d’exécution.
audit
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
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
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.