​

Cron vs Heartbeat : quand utiliser chacun

​

Guide de décision rapide

​

Heartbeat : vigilance périodique

​

Quand utiliser heartbeat

• Plusieurs vérifications périodiques : au lieu de 5 tâches cron distinctes vérifiant la boîte de réception, le calendrier, la météo, les notifications et l’état des projets, un seul heartbeat peut tout regrouper.
• Décisions conscientes du contexte : l’agent dispose de tout le contexte de la session principale et peut décider intelligemment de ce qui est urgent ou non.
• Continuité conversationnelle : les exécutions heartbeat partagent la même session, l’agent se souvient donc des conversations récentes et peut faire un suivi naturel.
• Surveillance à faible surcoût : un heartbeat remplace de nombreuses petites tâches de polling.

​

Avantages de heartbeat

• Regroupe plusieurs vérifications : un seul tour d’agent peut examiner la boîte de réception, le calendrier et les notifications ensemble.
• Réduit les appels API : un heartbeat unique coûte moins que 5 tâches cron isolées.
• Conscient du contexte : l’agent sait sur quoi vous avez travaillé et peut prioriser en conséquence.
• Suppression intelligente : si rien ne nécessite d’attention, l’agent répond HEARTBEAT_OK et aucun message n’est délivré.
• Timing naturel : dérive légèrement selon la charge de la file, ce qui convient à la plupart des surveillances.

​

Exemple de heartbeat : checklist HEARTBEAT.md

# Heartbeat checklist

- Check email for urgent messages
- Review calendar for events in next 2 hours
- If a background task finished, summarize results
- If idle for 8+ hours, send a brief check-in

​

Configuration de heartbeat

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m", // interval
        target: "last", // where to deliver alerts
        activeHours: { start: "08:00", end: "22:00" }, // optional
      },
    },
  },
}

​

Cron : planification précise

​

Quand utiliser cron

• Timing exact requis : « Envoyer ceci à 9h00 tous les lundis » (pas « vers 9h »).
• Tâches autonomes : tâches qui n’ont pas besoin de contexte conversationnel.
• Modèle/réflexion différente : analyses lourdes justifiant un modèle plus puissant.
• Rappels uniques : « Rappelle‑moi dans 20 minutes » avec --at.
• Tâches bruyantes/fréquentes : tâches qui encombreraient l’historique de la session principale.
• Déclencheurs externes : tâches devant s’exécuter indépendamment de l’activité de l’agent.

​

Avantages de cron

• Timing exact : expressions cron à 5 champs avec prise en charge des fuseaux horaires.
• Isolation de session : s’exécute dans cron:<jobId> sans polluer l’historique principal.
• Override de modèle : utiliser un modèle moins cher ou plus puissant par tâche.
• Contrôle de livraison : les tâches isolées utilisent par défaut announce (résumé) ; choisissez none si nécessaire.
• Livraison immédiate : le mode annonce publie directement sans attendre le heartbeat.
• Aucun contexte d’agent requis : s’exécute même si la session principale est inactive ou compactée.
• Support des tâches uniques : --at pour des horodatages futurs précis.

​

Exemple de cron : briefing matinal quotidien

openclaw cron add \
  --name "Morning briefing" \
  --cron "0 7 * * *" \
  --tz "America/New_York" \
  --session isolated \
  --message "Generate today's briefing: weather, calendar, top emails, news summary." \
  --model opus \
  --announce \
  --channel whatsapp \
  --to "+15551234567"

​

Exemple de cron : rappel unique

openclaw cron add \
  --name "Meeting reminder" \
  --at "20m" \
  --session main \
  --system-event "Reminder: standup meeting starts in 10 minutes." \
  --wake now \
  --delete-after-run

​

Diagramme de décision

Does the task need to run at an EXACT time?
  YES -> Use cron
  NO  -> Continue...

Does the task need isolation from main session?
  YES -> Use cron (isolated)
  NO  -> Continue...

Can this task be batched with other periodic checks?
  YES -> Use heartbeat (add to HEARTBEAT.md)
  NO  -> Use cron

Is this a one-shot reminder?
  YES -> Use cron with --at
  NO  -> Continue...

Does it need a different model or thinking level?
  YES -> Use cron (isolated) with --model/--thinking
  NO  -> Use heartbeat

​

Combiner les deux

1. Heartbeat gère la surveillance de routine (boîte de réception, calendrier, notifications) en un seul tour groupé toutes les 30 minutes.
2. Cron gère les plannings précis (rapports quotidiens, revues hebdomadaires) et les rappels uniques.

​

Exemple : configuration d’automatisation efficace

# Heartbeat checklist

- Scan inbox for urgent emails
- Check calendar for events in next 2h
- Review any pending tasks
- Light check-in if quiet for 8+ hours

# Daily morning briefing at 7am
openclaw cron add --name "Morning brief" --cron "0 7 * * *" --session isolated --message "..." --announce

# Weekly project review on Mondays at 9am
openclaw cron add --name "Weekly review" --cron "0 9 * * 1" --session isolated --message "..." --model opus

# One-shot reminder
openclaw cron add --name "Call back" --at "2h" --session main --system-event "Call back the client" --wake now

​

Lobster : workflows déterministes avec validations

​

Quand Lobster est adapté

• Automatisation multi‑étapes : vous avez besoin d’un pipeline fixe d’appels d’outils, pas d’un prompt ponctuel.
• Portes de validation : les effets de bord doivent s’interrompre jusqu’à votre approbation, puis reprendre.
• Exécutions reprenables : continuer un workflow en pause sans réexécuter les étapes précédentes.

​

Comment il se combine avec heartbeat et cron

• Heartbeat/cron décident quand une exécution a lieu.
• Lobster définit quelles étapes se produisent une fois l’exécution lancée.

​

Notes opérationnelles (issues du code)

• Lobster s’exécute comme un sous‑processus local (lobster CLI) en mode outil et renvoie une enveloppe JSON.
• Si l’outil renvoie needs_approval, vous reprenez avec resumeToken et l’option approve.
• L’outil est un plugin optionnel ; activez‑le de manière additive via tools.alsoAllow: ["lobster"] (recommandé).
• Si vous passez lobsterPath, il doit s’agir d’un chemin absolu.

​

Session principale vs session isolée

​

Quand utiliser un cron en session principale

• Que le rappel/l’événement apparaisse dans le contexte de la session principale
• Que l’agent le traite lors du prochain heartbeat avec tout le contexte
• Aucune exécution isolée séparée

openclaw cron add \
  --name "Check project" \
  --every "4h" \
  --session main \
  --system-event "Time for a project health check" \
  --wake now

​

Quand utiliser un cron isolé

• Une ardoise propre sans contexte préalable
• Des paramètres de modèle ou de réflexion différents
• Annoncer directement des résumés dans un canal
• Un historique qui n’encombre pas la session principale

openclaw cron add \
  --name "Deep analysis" \
  --cron "0 6 * * 0" \
  --session isolated \
  --message "Weekly codebase analysis..." \
  --model opus \
  --thinking high \
  --announce

​

Considérations de coût

• Gardez HEARTBEAT.md petit pour minimiser la surcharge de tokens.
• Regroupez des vérifications similaires dans heartbeat plutôt que plusieurs tâches cron.
• Utilisez target: "none" sur heartbeat si vous voulez uniquement un traitement interne.
• Utilisez un cron isolé avec un modèle moins cher pour les tâches de routine.

​

Liens connexes

• Heartbeat - configuration complète de heartbeat
• Cron jobs - référence complète CLI et API des tâches cron
• System - événements système + contrôles de heartbeat