Automatisation

OpenClaw exécute des travaux 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. Utilisez cette page pour choisir le mécanisme approprié.

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]

Tâches planifiées (Cron) ou Heartbeat

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 fondamentaux

Tâches planifiées (Cron)

Cron est le planificateur intégré du Gateway pour les horaires précis. Il conserve les travaux, réveille l’agent au moment approprié et peut transmettre le résultat à 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.

Consultez Tâches planifiées.

Tâches

Le registre des tâches en arrière-plan suit tous les travaux détachés : exécutions ACP, créations de sous-agents, exécutions Cron isolées et opérations de la CLI. Les tâches sont des enregistrements, pas des planificateurs. Utilisez openclaw tasks list et openclaw tasks audit pour les consulter.

Consultez Tâches en arrière-plan.

Engagements déduits

Les engagements sont des souvenirs de suivi facultatifs et de courte durée. OpenClaw les déduit des conversations ordinaires, les limite au même agent et au même canal, puis transmet les prises de nouvelles arrivées à échéance au moyen de Heartbeat. Les rappels précis explicitement demandés par l’utilisateur relèvent toujours de Cron.

Consultez Engagements déduits.

Flux de tâches

Le flux de tâches constitue la couche d’orchestration des flux au-dessus des tâches en arrière-plan. Il gère des flux durables en plusieurs étapes avec des modes de synchronisation gérés et en miroir, le suivi des révisions et les commandes openclaw tasks flow list|show|cancel pour leur consultation.

Consultez Flux de tâches.

Instructions permanentes

Les instructions permanentes accordent à l’agent une autorité opérationnelle durable pour des programmes définis. Elles résident dans les fichiers de l’espace de travail, généralement AGENTS.md, et sont injectées dans chaque session. Associez-les à Cron pour une application à des horaires définis.

Consultez Instructions permanentes.

Hooks

Les hooks internes sont des scripts pilotés par des événements et déclenchés par les événements du cycle de vie de l’agent (/new, /reset, /stop), la Compaction de session, le démarrage du Gateway et le flux de messages. Ils sont détectés dans les répertoires de hooks et gérés avec openclaw hooks. Pour intercepter les appels d’outils au sein du processus, utilisez les hooks de Plugin.

Consultez Hooks.

Heartbeat

Heartbeat est un tour périodique de la session principale, toutes les 30 minutes par défaut. Il regroupe plusieurs vérifications — boîte de réception, calendrier et notifications — dans un seul tour de l’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 période de fraîcheur avant la réinitialisation quotidienne ou pour inactivité de la session. Utilisez HEARTBEAT.md pour une courte liste de contrôle, ou un bloc tasks: pour effectuer uniquement les vérifications périodiques arrivées à échéance dans Heartbeat lui-même. Les fichiers Heartbeat vides sont ignorés avec empty-heartbeat-file ; le mode de tâches limité aux échéances est ignoré avec no-tasks-due. Les Heartbeats sont différés lorsque des travaux Cron sont actifs ou en attente, et heartbeat.skipWhenBusy peut également différer un agent lorsque les sous-agents associés à la clé de session de ce même agent ou ses voies imbriquées sont occupés.

Consultez Heartbeat.

Fonctionnement conjoint

• Cron gère les horaires précis — rapports quotidiens, bilans 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 — en un seul tour groupé toutes les 30 minutes.
• Les hooks réagissent à des événements précis — réinitialisations de session, Compaction, flux de messages — au moyen de scripts personnalisés. Les hooks de Plugin couvrent les appels d’outils.
• Les instructions permanentes fournissent à l’agent un contexte durable et des limites d’autorité.
• Le flux de tâches coordonne les flux en plusieurs étapes au-dessus des tâches individuelles.
• Les tâches suivent automatiquement tous les travaux détachés afin que vous puissiez les consulter et les auditer.

Pages connexes

• Tâches planifiées — planification précise et rappels uniques
• Engagements déduits — prises de nouvelles semblables à des souvenirs
• Tâches en arrière-plan — registre des tâches pour tous les travaux détachés
• Flux de tâches — orchestration durable de flux en plusieurs étapes
• Hooks — scripts de cycle de vie pilotés par les événements
• Hooks de Plugin — hooks intégrés au processus pour les outils, les prompts, les messages et le cycle de vie
• Instructions permanentes — instructions persistantes de l’agent
• Heartbeat — tours périodiques de la session principale
• Référence de configuration — toutes les clés de configuration