Automatisation

OpenClaw exécute des travaux en arrière-plan via des tâches, des travaux planifiés, des engagements déduits, des hooks d’événement et des 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’usage	Recommandé	Pourquoi
Envoyer un rapport quotidien à 9h précises	Tâches planifiées (Cron)	Timing exact, exécution isolée
Me rappeler dans 20 minutes	Tâches planifiées (Cron)	Usage unique avec un timing précis (--at)
Exécuter une analyse approfondie hebdomadaire	Tâches planifiées (Cron)	Tâche autonome, peut utiliser un model différent
Vérifier la boîte de réception toutes les 30 min	Heartbeat	Traitement par lot avec d’autres vérifications, contextuel
Surveiller le calendrier pour les événements à venir	Heartbeat	Adapté naturellement à la sensibilisation périodique
Faire un suivi après un entretien mentionné	Engagements déduits	Suivi de type mémoire, sans demande de rappel précise
Vérification de bienveillance après le contexte utilisateur	Engagements déduits	Délimité au même agent et channel
Inspecter l’état d’un sous-agent ou d’une exécution ACP	Tâches d’arrière-plan	Le registre des tâches suit tout le travail détaché
Auditer ce qui a été exécuté et quand	Tâches d’arrière-plan	openclaw tasks list et openclaw tasks audit
Recherche en plusieurs étapes puis résumé	Flux de tâches	Orchestration durable avec suivi des révisions
Exécuter un script lors de la réinitialisation de la session	Hooks	Piloté par événement, se déclenche sur les événements du cycle de vie
Exécuter du code à chaque appel d’outil	Hooks de plugin	Les hooks in-process peuvent intercepter les appels d’outil
Toujours vérifier la conformité avant de répondre	Ordres permanents	Injecté automatiquement dans chaque session

Tâches planifiées (Cron) vs Heartbeat

Dimension	Tâches planifiées (Cron)	Heartbeat
Minutage	Exact (expressions cron, one-shot)	Approximatif (par défaut toutes les 30 min)
Contexte de session	Nouveau (isolé) ou partagé	Contexte complet de la session principale
Enregistrements de tâches	Toujours créés	Jamais créés
Livraison	Channel, webhook ou silencieux	En ligne dans la session principale
Idéal pour	Rapports, rappels, travaux d’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 minutage 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 minutage approximatif convient.

Concepts clés

Tâches planifiées (cron)

Cron est le planificateur intégré du Gateway pour un minutage précis. Il persiste les travaux, réveille l’agent au bon moment et peut livrer la sortie à un channel de chat ou à un point de terminaison webhook. Prend en charge les rappels uniques, les expressions récurrentes et les déclencheurs de webhook entrants.

Voir Tâches planifiées.

Tâches

Le registre des tâches d’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 CLIopenclaw tasks list et openclaw tasks audit pour les inspecter.

Voir Tâches d’arrière-plan.

Engagements déduits

Les engagements sont des mémoires de suivi opt-in et à courte durée de vie. OpenClaw les déduit des conversations normales, les délimite au même agent et canal, et envoie les points de contrôle d’échéance via le heartbeat. Les rappels exacts demandés par l’utilisateur appartiennent toujours au cron.

Voir Engagements déduits.

Flux de tâches

Le Flux de tâches est le substrat d’orchestration de flux au-dessus des tâches d’arrière-plan. Il gère les flux multi-étapes durables avec des modes de synchronisation gérés et miroir, le suivi des révisions et openclaw tasks flow list|show|cancel pour l’inspection.

Voir Flux de tâches.

Ordres permanents

Les ordres permanents accordent à l’agent une autorité opérationnelle permanente pour les programmes définis. Ils résident dans les fichiers de l’espace de travail (généralement AGENTS.md) et sont injectés dans chaque session. Combinez avec cron pour une application basée sur le temps.

Voir Ordres permanents.

Hooks

Les hooks internes sont des scripts pilotés par les événements déclenchés par les événements du cycle de vie de l’agent (/new, /reset, /stop), la compactage de session, le démarrage de la passerelle et le flux de messages. Ils sont découverts automatiquement à partir des répertoires et peuvent être gérés avec openclaw hooks. Pour l’interception des appels d’outil in-process, utilisez Hooks de plugin.

Voir Hooks.

Heartbeat

Heartbeat est un tour de session principal périodique (par défaut toutes les 30 minutes). Il regroupe plusieurs vérifications (boîte de réception, calendrier, notifications) en un tour d’agent avec le contexte complet de la session. Les tours Heartbeat ne créent pas d’enregistrements de tâche et n’étendent pas la fraîcheur de la réinitialisation quotidienne/inactive de la session. Utilisez HEARTBEAT.md pour une petite liste de contrôle, ou un bloc tasks: lorsque vous souhaitez des vérifications périodiques dues uniquement à l’intérieur du heartbeat lui-même. Les fichiers heartbeat vides sont ignorés en tant que empty-heartbeat-file ; le mode de tâche due-only est ignoré en tant que no-tasks-due. Les heartbeats sont différés pendant que le travail cron est actif ou en file d’attente, et heartbeat.skipWhenBusy peut également différer un agent pendant que les sous-agents ou les volets imbriqués à clé de session de ce même agent sont occupés.

Voir Heartbeat.

Comment ils fonctionnent ensemble

• Cron gère les planifications précises (rapports quotidiens, revues hebdomadaires) et les rappels ponctuels. Toutes les exécutions cron créent des enregistrements de tâches.
• Heartbeat gère la surveillance de routine (boîte de réception, calendrier, notifications) en un seul tour groupé toutes les 30 minutes.
• Hooks réagissent à des événements spécifiques (réinitialisations de session, compactage, flux de messages) avec des scripts personnalisés. Les hooks de plugin couvrent les appels d’outils.
• Standing orders donnent à l’agent un contexte persistant et des limites d’autorité.
• Task Flow coordonne les flux multi-étapes au-dessus des tâches individuelles.
• Tasks suivent automatiquement tout le travail détaché afin que vous puissiez l’inspecter et l’auditer.

Connexes

• Scheduled Tasks — planification précise et rappels ponctuels
• Inferred Commitments — suivis de type mémoire
• Background Tasks — registre des tâches pour tout le travail détaché
• Task Flow — orchestration de flux multi-étapes durables
• Hooks — scripts de cycle de vie pilotés par les événements
• Plugin hooks — hooks d’outils, de invites, de messages et de cycle de vie in-process
• Standing Orders — instructions persistantes pour l’agent
• Heartbeat — tours de session principale périodiques
• Configuration Reference — toutes les clés de configuration