Heartbeat erklärt – Proaktive KI-Agenten mit OpenClaw

Was ist das Heartbeat-System?

Das Heartbeat-System ist eine der einzigartigen Funktionen von OpenClaw. Es ermöglicht deinem KI-Agenten, proaktiv zu handeln – also Aufgaben auszuführen, ohne dass du ihm explizit eine Nachricht schickst.

Im Gegensatz zu normalen Chatbots, die nur auf Anfragen reagieren, kann ein OpenClaw-Agent mit aktiviertem Heartbeat eigenständig arbeiten: das Internet überwachen, E-Mails lesen, Reports erstellen und dir Benachrichtigungen schicken.

Wie funktioniert Heartbeat?

Das Heartbeat-System basiert auf zeitgesteuerten Auslösern (ähnlich wie Cron Jobs in Linux):

1. Timer läuft ab (z.B. jeden Morgen um 6:30 Uhr)
2. Agent „erwacht" und prüft seine Heartbeat-Konfiguration
3. Aufgaben werden ausgeführt (z.B. Kalender prüfen, News lesen)
4. Ergebnisse werden gesendet (z.B. Briefing per Telegram)
5. Agent „schläft" wieder bis zum nächsten Heartbeat

Praxis-Beispiele

Morgen-Briefing (6:30 Uhr)

• Kalender des Tages zusammenfassen
• Wetter abfragen
• Wichtige E-Mails identifizieren
• Zusammenfassung per Telegram senden

Wettbewerbs-Monitoring (täglich, 10:00 Uhr)

• Websites von 5 Wettbewerbern scannen
• Preisänderungen erkennen
• Neue Produkte oder Features identifizieren
• Bericht erstellen und in Google Docs speichern

Wochen-Report (Freitag, 17:00 Uhr)

• Erledigte Aufgaben der Woche zusammenfassen
• Offene Tasks identifizieren
• Zusammenfassung per Telegram oder E-Mail senden

Heartbeat vs. Cron Jobs

| Feature | Heartbeat | Klassischer Cron Job | | --- | --- | --- | | Intelligenz | KI entscheidet, was relevant ist | Führt exakt den definierten Befehl aus | | Flexibilität | Passt sich an Kontext an | Statisch | | Ergebnis | Zusammengefasst, priorisiert | Rohdaten | | Fehlerbehandlung | Agent versteht Fehler | Script bricht ab |

Sicherheitshinweise

Da Heartbeat-Tasks ohne deine aktive Zustimmung laufen, beachte:

• Beschränke die Rechte: Definiere genau, was der Agent proaktiv tun darf
• Logging aktivieren: Protokolliere alle Heartbeat-Aktivitäten
• Sensible Aktionen ausschließen: Keine automatischen E-Mail-Sendungen ohne Review

Verwandte Konzepte

• Soul.md: Definiert die Persönlichkeit des Agenten
• Gateway: Der Prozess, der Heartbeat ermöglicht
• Skills: Fähigkeiten, die im Heartbeat genutzt werden

Details zur Heartbeat-Konfiguration lernst du in Modul 5 der Masterclass.