Les plannings d’automatisation d’OpenClaw

Une automatisation, ce sont deux décisions, quand elle se déclenche et ce qu’elle exécute ; ce billet porte sur la première. OpenClaw propose cinq types de planning, un petit jeu de règles de fuseau qui décident comment un horodatage ou une expression cron est lu, des sources de flux pilotées par événements qui transforment la sortie d’une commande de longue durée en exécutions, un rythme dynamique qui laisse une tâche proposer sa prochaine vérification, et des scripts de condition qui conditionnent un planning à un état observé. Voici les types et leurs options, les règles de fuseau et d’étalement, la mécanique des flux et du rythme, le piège cron que la documentation signale, et le contrat des surveillants.

Les cinq types

• Ponctuel se déclenche une fois à un horodatage ISO ou un délai relatif comme vingt minutes ; intervalle se déclenche à cadence fixe ; cron prend une expression à cinq ou six champs avec un fuseau facultatif ; à la sortie se déclenche une fois quand une commande surveillée se termine, un déclencheur d’événement qui survit au démontage du tour ; et flux se déclenche à partir de lignes regroupées produites par une commande supervisée de longue durée. Les mêmes options fonctionnent à l’ajout et à la modification, donc une tâche existante peut être convertie en tâche déclenchée à la sortie.
• Les horodatages sans fuseau sont traités comme UTC ; l’option de fuseau interprète une date ponctuelle sans décalage ou évalue une expression cron dans une zone IANA, les expressions cron sans elle utilisent le fuseau de l’hôte de la passerelle, et l’option est invalide avec intervalle et à la sortie.
• Les expressions récurrentes en début d’heure, minute zéro avec un champ d’heure joker, sont automatiquement étalées jusqu’à cinq minutes pour réduire les pics de charge ; une option d’exactitude force l’heure précise et une option d’étalement fixe une fenêtre explicite, pour les plannings cron seulement.
• Le bloc-notes du battement de cœur acceptait un bloc de tâches structuré avant la version 2026.8.1 ; la correction du doctor convertit chaque entrée en tâche ordinaire modifiable de session principale, en préservant l’intervalle et le dernier horaire d’exécution, et les battements de cœur n’analysent plus ce texte comme des plannings. Les tâches migrées passent encore par le réveil gardé du battement de cœur avec heures actives, espacement minimal, contrôle d’inondation et relances si occupé, et une occurrence hors des heures actives est sautée et retentée à la suivante.

Concevez les surveillants autour d’un état exploitable, pas seulement du succès : un surveillant qui se tait quand sa vérification échoue ou expire paraît sain alors qu’il est cassé.

Flux et rythme

Un planning de flux garde une commande argv écrite par l’opérateur en cours d’exécution sous la passerelle et déclenche la tâche à partir de ses lignes de sortie standard et d’erreur ; il est piloté par événements, jamais dû à l’heure, et disponible par défaut, avec un réglage de déclencheurs qui désactive ensemble les flux, les scripts de condition et les charges de script. Le mode ligne accepte chaque ligne, le mode correspondance seulement les lignes qui correspondent à une expression régulière compilée, un lot se ferme après une période de calme de 250 millisecondes par défaut dans une plage bornée ou à un plafond d’octets de seize kilooctets par défaut, et au plafond le lot se termine par un marqueur de troncature tandis que le mode correspondance évalue toujours les lignes complètes sur leur texte entier. Les échecs rapides redémarrent avec le recul d’erreur du planificateur, cinq exécutions consécutives de moins de soixante secondes laissent la tâche en état d’erreur jusqu’à sa réactivation, un seul déclenchement de charge et un seul lot en attente borné sont retenus par tâche, les lignes arrivant pendant une exécution ou avant l’intervalle de déclenchement intégré de trente secondes fusionnent au lieu de s’empiler, les charges échouées ne sont pas relancées parce qu’elles peuvent ne pas être idempotentes, et l’identité d’une source tourne quand elle est désactivée, retirée ou remplacée pour que les lots retirés ne puissent pas se déclencher. Il n’y a pas de source WebSocket native ; reliez-en une avec un client en ligne de commande. Le rythme laisse une tâche récurrente fixer des bornes minimale et maximale, et pendant une exécution la tâche peut proposer sa prochaine vérification par l’outil d’automatisations, mesurée depuis l’achèvement réussi, bornée en silence, abandonnée par les exécutions échouées, expirées ou sautées, et survivant à un redémarrage de la passerelle. En chat, la commande de boucle réservée au propriétaire crée une tâche récurrente liée à cette conversation, à intervalle fixe ou à rythme autonome entre une minute et une heure.

Le piège cron et les surveillants

• Les expressions cron sont analysées par croner, et quand le jour du mois et le jour de la semaine sont tous deux non jokers, la tâche se déclenche quand l’un ou l’autre correspond, comportement Vixie standard : neuf heures le quinze si c’est un lundi se déclenche en réalité chaque quinze et chaque lundi. Pour exiger les deux, utilisez le modificateur plus de croner sur le champ du jour de la semaine, ou planifiez sur un champ et gardez l’autre dans le prompt.
• Un déclencheur d’événement ajoute un script de condition sans interface à un planning à intervalle, cron ou de flux ; les plannings temporels l’évaluent à l’échéance et les flux par lot fermé, et la charge ne tourne que quand le script renvoie fire vrai, éventuellement avec un message ajouté au texte de l’événement et une valeur d’état conservée jusqu’à seize kilooctets et rendue gelée à l’évaluation suivante. Une option unique désactive la tâche après sa première charge déclenchée, fire faux conserve l’état et replanifie sans créer d’historique, et si une charge déclenchée échoue l’état renvoyé n’est pas conservé, donc les scripts doivent être des vérifications en lecture seule avec les actions dans la charge. Les plannings à déclencheur ont un intervalle minimal de trente secondes, et chaque évaluation reçoit un budget de trente secondes et jusqu’à cinq appels d’outils ; modifier la condition ou l’état d’un surveillant en cours protège cette modification de l’ancienne évaluation.
• L’avertissement compte : les scripts de condition et les charges de script tournent sans surveillance avec toute la politique d’outils de l’agent propriétaire, exec compris, et les plannings de flux gardent des commandes écrites par l’opérateur en cours sans surveillance, donc la documentation dit de les traiter comme une exécution de code sans surveillance avec les permissions de cet agent et de passer le réglage des déclencheurs à faux pour un arrêt franc. Un surveillant se crée depuis un fichier de script local ou l’entrée standard avec une option de script de déclencheur à côté du planning et du message.

Les automatisations d’OpenClaw est le guide auquel ces plannings appartiennent, et Les fuseaux horaires dans OpenClaw explique le fuseau dans lequel une expression cron est lue sans option.

D’où viennent les événements

Les sources de flux et les plannings à la sortie couvrent les cas où le déclencheur est un processus plutôt qu’une horloge ; pour les événements HTTP entrants, le chemin des webhooks est le mécanisme voisin. Le battement de cœur d’OpenClaw est le cycle que les tâches de battement de cœur migrées empruntent encore, et Hooks et webhooks dans OpenClaw les scripts et webhooks pilotés par événements qui se placent à côté des plannings.

Sur Diali

Sur Diali, les types temporels sont ce que l’écran des automatisations du tableau de bord crée, dans le fuseau choisi à l’intégration ; les scripts de condition et les sources de flux tournent sans surveillance avec toute la politique d’outils de l’assistant, donc traitez-les comme du code de confiance. OpenClaw hébergé sur Diali est l’assistant et Les ordres permanents d’OpenClaw l’autorité qu’une tâche planifiée fait généralement respecter.

• Ponctuel, intervalle, cron, à la sortie, flux.
• Sans décalage signifie UTC ; les champs de jour sont un OU, pas un ET.
• Les surveillants tournent avec tous les outils de l’agent ; écrivez-les en lecture seule.