Automation and tasks
Automatisation et tâches
OpenClaw exécute du travail en arrière-plan au moyen de tâches, de travaux planifiés, d’engagements déduits, de hooks d’événements et d’instructions permanentes. Cette page vous aide à choisir le bon mécanisme et à comprendre comment ils s’articulent.
Guide de décision rapide
flowchart TD
START([What do you need?]) --> Q1{Schedule work?}
START --> Q2{Track detached work?}
START --> Q3{Orchestrate multi-step flows?}
START --> Q4{React to lifecycle events?}
START --> Q5{Give the agent persistent instructions?}
START --> Q6{Remember a natural follow-up?}
Q1 -->|Yes| Q1a{Exact timing or flexible?}
Q1a -->|Exact| CRON["Scheduled Tasks (Cron)"]
Q1a -->|Flexible| HEARTBEAT[Heartbeat]
Q2 -->|Yes| TASKS[Background Tasks]
Q3 -->|Yes| FLOW[Task Flow]
Q4 -->|Yes| HOOKS[Hooks]
Q5 -->|Yes| SO[Standing Orders]
Q6 -->|Yes| COMMITMENTS[Inferred Commitments]
| Cas d’utilisation | Recommandé | Pourquoi |
|---|---|---|
| Envoyer un rapport quotidien à 9 h précises | Tâches planifiées (Cron) | Horaire exact, exécution isolée |
| Me le rappeler dans 20 minutes | Tâches planifiées (Cron) | Exécution unique avec horaire précis (--at) |
| Exécuter une analyse approfondie hebdomadaire | Tâches planifiées (Cron) | Tâche autonome, peut utiliser un modèle différent |
| Vérifier la boîte de réception toutes les 30 min | Heartbeat | Regroupé avec d’autres vérifications, contextuel |
| Surveiller le calendrier pour les événements à venir | Heartbeat | Adapté naturellement à une vigilance périodique |
| Faire un suivi après un entretien mentionné | Engagements déduits | Suivi de type mémoire, sans demande de rappel exact |
| Point de suivi bienveillant après le contexte utilisateur | Engagements déduits | Limité au même agent et au même canal |
| Inspecter l’état d’un sous-agent ou d’une exécution ACP | Tâches en arrière-plan | Le registre des tâches suit tout le travail détaché |
| Auditer ce qui s’est exécuté et quand | Tâches en arrière-plan | openclaw tasks list et openclaw tasks audit |
| Recherche multi-étapes puis synthèse | TaskFlow | Orchestration durable avec suivi des révisions |
| Exécuter un script lors de la réinitialisation d’une session | Hooks | Piloté par les événements, déclenché par les événements du cycle de vie |
| Exécuter du code à chaque appel d’outil | Hooks de Plugin | Les hooks en processus peuvent intercepter les appels d’outils |
| Toujours vérifier la conformité avant de répondre | Instructions permanentes | Injectées automatiquement dans chaque session |
Tâches planifiées (Cron) vs Heartbeat
| Dimension | Tâches planifiées (Cron) | Heartbeat |
|---|---|---|
| Horaire | Exact (expressions cron, exécution unique) | Approximatif (par défaut toutes les 30 min) |
| Contexte de session | Frais (isolé) ou partagé | Contexte complet de la session principale |
| Enregistrements de tâches | Toujours créés | Jamais créés |
| Livraison | Canal, Webhook ou silencieuse | En ligne dans la session principale |
| Idéal pour | Rapports, rappels, travaux en arrière-plan | Vérifications de boîte de réception, calendrier, notifications |
Utilisez les tâches planifiées (Cron) lorsque vous avez besoin d’un horaire précis ou d’une exécution isolée. Utilisez Heartbeat lorsque le travail bénéficie du contexte complet de la session et qu’un horaire approximatif convient.
Concepts clés
Tâches planifiées (cron)
Cron est le planificateur intégré du Gateway pour les horaires précis. Il persiste les travaux, réveille l’agent au bon moment et peut livrer la sortie à un canal de discussion ou à un point de terminaison Webhook. Il prend en charge les rappels uniques, les expressions récurrentes et les déclencheurs Webhook entrants.
Voir Tâches planifiées.
Tâches
Le registre des tâches en arrière-plan suit tout le travail détaché : exécutions ACP, lancements de sous-agents, exécutions cron isolées et opérations CLI. Les tâches sont des enregistrements, pas des planificateurs. Utilisez openclaw tasks list et openclaw tasks audit pour les inspecter.
Voir Tâches en arrière-plan.
Engagements déduits
Les engagements sont des mémoires de suivi optionnelles et de courte durée. OpenClaw les déduit des conversations normales, les limite au même agent et au même canal, et livre les points de suivi arrivés à échéance via Heartbeat. Les rappels exacts demandés par l’utilisateur relèvent toujours de cron.
Voir Engagements déduits.
TaskFlow
TaskFlow est la couche d’orchestration de flux au-dessus des tâches en arrière-plan. Il gère des flux multi-étapes durables avec des modes de synchronisation gérés et miroirs, le suivi des révisions, et openclaw tasks flow list|show|cancel pour l’inspection.
Voir TaskFlow.
Instructions permanentes
Les instructions permanentes accordent à l’agent une autorité opérationnelle permanente pour des programmes définis. Elles résident dans des fichiers de l’espace de travail (généralement AGENTS.md) et sont injectées dans chaque session. Combinez-les avec cron pour une application basée sur le temps.
Voir Instructions permanentes.
Hooks
Les hooks internes sont des scripts pilotés par les événements et déclenchés par des événements du cycle de vie de l’agent (/new, /reset, /stop), par la Compaction de session, par le démarrage du Gateway et par le flux de messages. Ils sont découverts automatiquement à partir de répertoires et peuvent être gérés avec openclaw hooks. Pour l’interception des appels d’outils en processus, utilisez les hooks de Plugin.
Voir Hooks.
Heartbeat
Heartbeat est un tour périodique de session principale (par défaut toutes les 30 minutes). Il regroupe plusieurs vérifications (boîte de réception, calendrier, notifications) dans un seul tour d’agent avec le contexte complet de la session. Les tours Heartbeat ne créent pas d’enregistrements de tâches et ne prolongent pas la fraîcheur de réinitialisation quotidienne/inactive de la session. Utilisez HEARTBEAT.md pour une petite liste de contrôle, ou un bloc tasks: lorsque vous voulez des vérifications périodiques uniquement échues dans Heartbeat lui-même. Les fichiers Heartbeat vides sont ignorés avec empty-heartbeat-file; le mode de tâches uniquement échues est ignoré avec no-tasks-due. Les Heartbeats sont différés pendant qu’un travail cron est actif ou en file d’attente, et heartbeat.skipWhenBusy peut aussi les différer lorsque des sous-agents ou des voies imbriquées sont occupés.
Voir Heartbeat.
Comment ils fonctionnent ensemble
- Cron gère les calendriers précis (rapports quotidiens, revues hebdomadaires) et les rappels uniques. Toutes les exécutions cron créent des enregistrements de tâches.
- Heartbeat gère la surveillance courante (boîte de réception, calendrier, notifications) dans un tour regroupé toutes les 30 minutes.
- Hooks réagit à des événements spécifiques (réinitialisations de session, Compaction, flux de messages) avec des scripts personnalisés. Les hooks de Plugin couvrent les appels d’outils.
- Instructions permanentes donnent à l’agent un contexte persistant et des limites d’autorité.
- TaskFlow coordonne les flux multi-étapes au-dessus des tâches individuelles.
- Tâches suit automatiquement tout le travail détaché afin que vous puissiez l’inspecter et l’auditer.
Connexe
- Tâches planifiées — planification précise et rappels uniques
- Engagements déduits — points de suivi de type mémoire
- Tâches en arrière-plan — registre des tâches pour tout le travail détaché
- TaskFlow — orchestration durable de flux multi-étapes
- Hooks — scripts de cycle de vie pilotés par les événements
- Hooks de Plugin — hooks en processus pour outils, prompts, messages et cycle de vie
- Instructions permanentes — instructions persistantes de l’agent
- Heartbeat — tours périodiques de session principale
- Référence de configuration — toutes les clés de configuration