​

Cron vs. Heartbeat: Wann Sie was verwenden sollten

​

Schnellentscheidungshilfe

​

Heartbeat: Periodische Aufmerksamkeit

​

Wann Sie Heartbeat verwenden sollten

• Mehrere periodische Prüfungen: Statt 5 separater Cron-Jobs für Posteingang, Kalender, Wetter, Benachrichtigungen und Projektstatus kann ein einzelner Heartbeat all dies bündeln.
• Kontextbewusste Entscheidungen: Der Agent hat den vollständigen Kontext der Hauptsitzung und kann intelligent entscheiden, was dringend ist und was warten kann.
• Konversationelle Kontinuität: Heartbeat-Läufe teilen dieselbe Sitzung, sodass sich der Agent an kürzliche Gespräche erinnert und natürlich nachfassen kann.
• Überwachung mit geringem Overhead: Ein Heartbeat ersetzt viele kleine Polling-Aufgaben.

​

Vorteile von Heartbeat

• Bündelt mehrere Prüfungen: Ein Agenten-Zug kann Posteingang, Kalender und Benachrichtigungen gemeinsam prüfen.
• Reduziert API-Aufrufe: Ein einzelner Heartbeat ist günstiger als 5 isolierte Cron-Jobs.
• Kontextbewusst: Der Agent weiß, woran Sie gearbeitet haben, und kann entsprechend priorisieren.
• Intelligente Unterdrückung: Wenn nichts Aufmerksamkeit erfordert, antwortet der Agent mit HEARTBEAT_OK und es wird keine Nachricht zugestellt.
• Natürliches Timing: Verschiebt sich leicht je nach Warteschlangenlast, was für die meisten Überwachungen ausreichend ist.

​

Heartbeat-Beispiel: HEARTBEAT.md-Checkliste

# 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

​

Heartbeat konfigurieren

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

​

Cron: Präzise Zeitplanung

​

Wann Sie Cron verwenden sollten

• Exaktes Timing erforderlich: „Sende dies jeden Montag um 9:00 Uhr“ (nicht „irgendwann um 9“).
• Eigenständige Aufgaben: Aufgaben, die keinen konversationellen Kontext benötigen.
• Anderes Modell/Denken: Aufwendige Analysen, die ein leistungsfähigeres Modell rechtfertigen.
• Einmalige Erinnerungen: „Erinnere mich in 20 Minuten“ mit --at.
• Lautstarke/häufige Aufgaben: Aufgaben, die den Verlauf der Hauptsitzung überladen würden.
• Externe Trigger: Aufgaben, die unabhängig davon laufen sollen, ob der Agent sonst aktiv ist.

​

Vorteile von Cron

• Exaktes Timing: 5-Feld-Cron-Ausdrücke mit Zeitzonenunterstützung.
• Sitzungsisolation: Läuft in cron:<jobId>, ohne den Hauptverlauf zu verschmutzen.
• Modellüberschreibungen: Verwenden Sie pro Job ein günstigeres oder leistungsfähigeres Modell.
• Zustellkontrolle: Isolierte Jobs verwenden standardmäßig announce (Zusammenfassung); wählen Sie bei Bedarf none.
• Sofortige Zustellung: Der Ankündigungsmodus postet direkt, ohne auf den Heartbeat zu warten.
• Kein Agentenkontext nötig: Läuft auch, wenn die Hauptsitzung inaktiv oder komprimiert ist.
• Einmalige Ausführung: --at für präzise zukünftige Zeitstempel.

​

Cron-Beispiel: Tägliches Morgenbriefing

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"

​

Cron-Beispiel: Einmalige Erinnerung

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

​

Entscheidungsflussdiagramm

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

​

Kombination beider Ansätze

1. Heartbeat übernimmt die routinemäßige Überwachung (Posteingang, Kalender, Benachrichtigungen) in einem gebündelten Zug alle 30 Minuten.
2. Cron übernimmt präzise Zeitpläne (tägliche Berichte, wöchentliche Reviews) und einmalige Erinnerungen.

​

Beispiel: Effiziente Automatisierungseinrichtung

# 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: Deterministische Workflows mit Freigaben

​

Wann Lobster passt

• Mehrstufige Automatisierung: Sie benötigen eine feste Pipeline von Tool-Aufrufen, keinen einmaligen Prompt.
• Genehmigungsgates: Nebeneffekte sollten pausieren, bis du freigeschaltet hast, und dann wieder fortfahren.
• Wiederaufnehmbare Läufe: Setzen Sie einen pausierten Workflow fort, ohne frühere Schritte erneut auszuführen.

​

Zusammenspiel mit Heartbeat und Cron

• Heartbeat/Cron entscheiden, wann ein Lauf stattfindet.
• Lobster definiert, welche Schritte stattfinden, sobald der Lauf startet.

​

Operative Hinweise (aus dem Code)

• Lobster läuft als lokaler Subprozess (lobster CLI) im Tool-Modus und gibt einen JSON-Umschlag zurück.
• Wenn das Tool needs_approval zurückgibt, setzen Sie mit resumeToken und dem Flag approve fort.
• Das Tool ist ein optionales Plugin; aktivieren Sie es additiv über tools.alsoAllow: ["lobster"] (empfohlen).
• Wenn Sie lobsterPath übergeben, muss es ein absoluter Pfad sein.

​

Hauptsitzung vs. isolierte Sitzung

​

Wann Sie Cron in der Hauptsitzung verwenden sollten

• Die Erinnerung/das Ereignis soll im Kontext der Hauptsitzung erscheinen
• Der Agent soll es beim nächsten Heartbeat mit vollem Kontext verarbeiten
• Kein separater isolierter Lauf

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

​

Wann Sie isolierten Cron verwenden sollten

• Ein unbeschriebenes Blatt ohne vorherigen Kontext
• Andere Modell- oder Denk-Einstellungen
• Zusammenfassungen direkt in einem Kanal ankündigen
• Verlauf, der die Hauptsitzung nicht überlädt

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

​

Kostenüberlegungen

• Halten Sie HEARTBEAT.md klein, um den Token-Overhead zu minimieren.
• Bündeln Sie ähnliche Prüfungen in Heartbeat statt in mehreren Cron-Jobs.
• Verwenden Sie target: "none" bei Heartbeat, wenn Sie nur interne Verarbeitung wünschen.
• Nutzen Sie isolierten Cron mit einem günstigeren Modell für Routineaufgaben.

​

Verwandt

• Heartbeat – vollständige Heartbeat-Konfiguration
• Cron jobs – vollständige Cron-CLI- und API-Referenz
• System – Systemereignisse + Heartbeat-Steuerung