Quand utiliser Task Flow
Utilisez Task Flow lorsque le travail couvre plusieurs étapes séquentielles ou ramifiées et que vous avez besoin d’un suivi de progression durable entre les redémarrages du Gateway. Pour les opérations uniques en arrière-plan, une simple tâche suffit.| Scénario | Utilisation |
|---|---|
| Tâche unique en arrière-plan | Tâche simple |
| Pipeline en plusieurs étapes (A puis B puis C) | Task Flow (géré) |
| Observer des tâches créées à l’extérieur | Task Flow (miroir) |
| Rappel ponctuel | Tâche Cron |
Modèle fiable de workflow planifié
Pour les workflows récurrents tels que les briefings de veille marché, traitez la planification, l’orchestration et les vérifications de fiabilité comme des couches séparées :- Utilisez les tâches planifiées pour le timing.
- Utilisez une session cron persistante lorsque le workflow doit s’appuyer sur le contexte précédent.
- Utilisez Lobster pour les étapes déterministes, les points d’approbation et les jetons de reprise.
- Utilisez Task Flow pour suivre l’exécution en plusieurs étapes entre les tâches enfants, les attentes, les nouvelles tentatives et les redémarrages du Gateway.
session:<id> au lieu de isolated lorsque le workflow récurrent a besoin d’un historique délibéré, de résumés d’exécutions précédentes ou d’un contexte permanent. Utilisez isolated lorsque chaque exécution doit repartir de zéro et que tout l’état requis est explicite dans le workflow.
Dans le workflow, placez les vérifications de fiabilité avant l’étape de résumé du LLM :
- Disponibilité du navigateur et choix du profil, par exemple
openclawpour l’état géré ouuserlorsqu’une session Chrome connectée est requise. Consultez Navigateur. - Identifiants d’API et quota pour chaque source.
- Accessibilité réseau des points de terminaison requis.
- Outils requis activés pour l’agent, tels que
lobster,browseretllm-task. - Destination d’échec configurée pour cron afin que les échecs de pré-vérification soient visibles. Consultez Tâches planifiées.
sourceUrl, retrievedAt et asOf dans sa sortie. Utilisez LLM Task lorsque vous avez besoin d’une étape de modèle validée par schéma dans le workflow.
Pour les workflows réutilisables par une équipe ou une communauté, empaquetez la CLI, les fichiers .lobster et toute note de configuration sous forme de skill ou de plugin, puis publiez-les via ClawHub. Conservez les garde-fous propres au workflow dans ce paquet, sauf s’il manque une capacité générique nécessaire à l’API du plugin.
Modes de synchronisation
Mode géré
Task Flow possède le cycle de vie de bout en bout. Il crée des tâches comme étapes de flux, les mène jusqu’à leur achèvement et fait avancer automatiquement l’état du flux. Exemple : un flux de rapport hebdomadaire qui (1) collecte les données, (2) génère le rapport et (3) le livre. Task Flow crée chaque étape comme tâche en arrière-plan, attend son achèvement, puis passe à l’étape suivante.Mode miroir
Task Flow observe les tâches créées à l’extérieur et maintient l’état du flux synchronisé sans prendre en charge la création des tâches. C’est utile lorsque les tâches proviennent de tâches cron, de commandes CLI ou d’autres sources, et que vous souhaitez une vue unifiée de leur progression sous forme de flux. Exemple : trois tâches cron indépendantes qui forment ensemble une routine « opérations du matin ». Un flux miroir suit leur progression collective sans contrôler quand ni comment elles s’exécutent.État durable et suivi de révision
Chaque flux persiste son propre état et suit les révisions afin que la progression survive aux redémarrages du Gateway. Le suivi de révision permet la détection des conflits lorsque plusieurs sources tentent de faire avancer le même flux simultanément. Le registre des flux utilise SQLite avec une maintenance bornée du journal d’écriture anticipée, y compris des points de contrôle périodiques et à l’arrêt, afin que les Gateways à longue durée d’exécution ne conservent pas de fichiers annexesregistry.sqlite-wal non bornés.
Comportement d’annulation
openclaw tasks flow cancel définit une intention d’annulation persistante sur le flux. Les tâches actives dans le flux sont annulées et aucune nouvelle étape n’est démarrée. L’intention d’annulation persiste entre les redémarrages ; un flux annulé reste donc annulé même si le Gateway redémarre avant que toutes les tâches enfants se soient terminées.
Commandes CLI
| Commande | Description |
|---|---|
openclaw tasks flow list | Affiche les flux suivis avec leur statut et leur mode de synchronisation |
openclaw tasks flow show <id> | Inspecte un flux par identifiant de flux ou clé de recherche |
openclaw tasks flow cancel <id> | Annule un flux en cours d’exécution et ses tâches actives |
Relation entre les flux et les tâches
Les flux coordonnent les tâches, ils ne les remplacent pas. Un même flux peut piloter plusieurs tâches en arrière-plan au cours de sa durée de vie. Utilisezopenclaw tasks pour inspecter les enregistrements de tâches individuelles et openclaw tasks flow pour inspecter le flux d’orchestration.
Associé
- Tâches en arrière-plan — le registre de travail détaché que les flux coordonnent
- CLI : tâches — référence des commandes CLI pour
openclaw tasks flow - Vue d’ensemble de l’automatisation — tous les mécanismes d’automatisation en un coup d’œil
- Tâches Cron — tâches planifiées qui peuvent alimenter des flux