Heartbeat des agents IA : quand l'assistant prend l'initiative
Découvrez comment le heartbeat transforme votre agent IA passif en collègue proactif qui vous alerte au bon moment, sans jamais vous spammer.
Vous connaissez cette sensation. Vous travaillez sur un projet, une tâche traîne dans un coin de votre tête, et vous oubliez de vérifier un détail qui aurait tout changé. Maintenant, imaginez qu'un agent IA fasse le tour de votre session à intervalles réguliers, repère ce qui mérite votre attention et vous le glisse au bon moment. C'est exactement ce que permet le mécanisme de heartbeat dans les architectures d'agents modernes.
Le heartbeat, c'est quoi au juste
Un heartbeat est une automatisation pilotée par le système qui déclenche périodiquement un tour d'agent dans la session principale. Concrètement, votre modèle IA se réveille à intervalles réguliers, examine l'état de la conversation et décide de faire remonter ce qui nécessite votre attention. Pas de notification à outrance, pas de silence total : juste ce qu'il faut, quand il faut.
La nuance est importante. Il ne s'agit pas d'un simple minuteur qui envoie un message vide. Le heartbeat donne au modèle une occasion réelle de réfléchir à ce qui compte dans votre contexte, puis de choisir s'il doit intervenir. Vous gardez la main, mais l'agent cesse d'être purement réactif.
Pourquoi cette cadence change la donne
La plupart des assistants IA que vous utilisez aujourd'hui attendent sagement que vous écriviez quelque chose. C'est pratique, mais limité. Un agent doté d'un heartbeat peut, par exemple, vous prévenir qu'un traitement long s'est terminé, qu'une donnée a changé, ou qu'une échéance approche. Vous ne perdez plus de temps à surveiller.
Un rythme maîtrisé, pas une avalanche
Le système gère la cadence via un planificateur d'automatisations. Le gateway maintient une tâche système dédiée par agent activé, visible dans openclaw cron list --all sous la forme Heartbeat (agent-id) . Vous ajustez la configuration, mais c'est le planificateur qui possède le tic réel et le temps de refroidissement. Résultat : vous définissez l'intention, le système gère la mécanique.
Ce qui reste sous votre contrôle
Vous modifiez
agents.*.heartbeat
, jamais directement la tâche d'automatisation. Si vous voulez couper la cadence récurrente, réglez
heartbeat.every: "0m"
. Attention : cela désactive uniquement le rythme périodique. Un réveil ponctuel déclenché par un événement, comme la fin d'un
exec
en arrière-plan, peut toujours provoquer un tour d'agent. Vous gardez donc la souplesse sans subir la répétition.
Heartbeat et agents : le duo qui rend l'IA vraiment utile
Dans un écosystème d'agents IA, tout ne se joue pas dans la session principale. Les exécutions ACP, les sous-agents et les jobs isolés ont leurs propres propriétaires d'exécution. Le heartbeat, lui, reste un tour de session principale. Cette séparation évite les collisions et garde chaque automatisation à sa place.
- Le heartbeat surveille votre session principale et fait surface l'essentiel.
- Les sous-agents gèrent leurs propres tâches sans interférer.
- Les jobs isolés tournent en arrière-plan avec leur propre logique.
Résultat : votre agent IA devient un véritable collaborateur qui sait quand parler et quand se taire.
Les pièges à connaître
Un heartbeat planifié dépend des automatisations. Si
cron.enabled
est à
false
ou si
OPENCLAW_SKIP_CRON=1
est défini, le gateway enregistre un avertissement au démarrage et n'exécute plus les heartbeats planifiés. Bonne nouvelle : les réveils manuels et événementiels restent disponibles. Il n'existe pas de minuteur de secours séparé, donc si vous comptez sur la cadence récurrente, vérifiez votre configuration.
Autre point : si l'enregistrement des lignes du moniteur échoue après un changement de configuration accepté, le gateway conserve la configuration acceptée et signale qu'une récupération est nécessaire. Les tentatives du moniteur utilisent alors la configuration acceptée courante. Les changements rejetés ne deviennent jamais des cibles de nouvelle tentative. Comprendre cette mécanique vous évite bien des surprises.
Pourquoi c'est important
Parce qu'un agent IA qui sait prendre l'initiative au bon moment change votre rapport au travail. Vous ne courez plus après l'information : elle vient à vous quand elle compte. Et vous gardez le contrôle total sur la fréquence et les conditions de ces réveils.
Conclusion
Le heartbeat n'est pas un gadget : c'est la brique qui transforme un assistant passif en partenaire attentif. En donnant à votre agent IA un rythme maîtrisé, vous gagnez en sérénité et en réactivité. La prochaine fois qu'une information importante vous parviendra sans que vous l'ayez demandée, vous saurez pourquoi.
Points clés à retenir
- Le heartbeat déclenche périodiquement un tour d'agent dans la session principale pour faire surface ce qui compte.
- La cadence est gérée par le planificateur d'automatisations, pas par un minuteur séparé.
-
Régler
heartbeat.every: "0m"coupe la récurrence, mais pas les réveils événementiels. - Sans automatisations actives, les heartbeats planifiés ne tournent plus, mais les réveils manuels restent possibles.
- Vous configurez l'intention, le système gère la mécanique : c'est ce qui évite le spam.