Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw führt Arbeit im Hintergrund über Aufgaben, geplante Jobs, abgeleitete Zusagen, Ereignis-Hooks und ständige Anweisungen aus. Diese Seite hilft Ihnen, den richtigen Mechanismus auszuwählen und zu verstehen, wie sie zusammenpassen.

Schnelle Entscheidungshilfe

AnwendungsfallEmpfohlenWarum
Täglichen Bericht pünktlich um 9 Uhr sendenGeplante Aufgaben (Cron)Exakter Zeitpunkt, isolierte Ausführung
Erinnern Sie mich in 20 MinutenGeplante Aufgaben (Cron)Einmalige Ausführung mit präzisem Zeitpunkt (--at)
Wöchentliche Tiefenanalyse ausführenGeplante Aufgaben (Cron)Eigenständige Aufgabe, kann anderes Modell verwenden
Posteingang alle 30 Minuten prüfenHeartbeatBündelt mit anderen Prüfungen, kontextbewusst
Kalender auf bevorstehende Ereignisse überwachenHeartbeatNatürliche Passung für regelmäßige Aufmerksamkeit
Nach einem erwähnten Vorstellungsgespräch nachfassenAbgeleitete ZusagenErinnerungsähnliche Nachverfolgung, keine exakte Erinnerungsanfrage
Behutsamer Fürsorge-Check-in nach BenutzerkontextAbgeleitete ZusagenAuf denselben Agenten und Kanal begrenzt
Status eines Subagenten oder ACP-Laufs prüfenHintergrundaufgabenAufgabenbuch verfolgt alle abgekoppelten Arbeiten
Prüfen, was wann gelaufen istHintergrundaufgabenopenclaw tasks list und openclaw tasks audit
Mehrstufige Recherche, dann zusammenfassenTask FlowDauerhafte Orchestrierung mit Revisionsverfolgung
Skript bei Sitzungszurücksetzung ausführenHooksEreignisgesteuert, wird bei Lebenszyklusereignissen ausgelöst
Code bei jedem Tool-Aufruf ausführenPlugin-HooksIn-Process-Hooks können Tool-Aufrufe abfangen
Compliance vor jeder Antwort immer prüfenStändige AnweisungenWird automatisch in jede Sitzung eingefügt

Geplante Aufgaben (Cron) vs. Heartbeat

DimensionGeplante Aufgaben (Cron)Heartbeat
ZeitpunktExakt (Cron-Ausdrücke, einmalig)Ungefähr (standardmäßig alle 30 Min.)
SitzungskontextFrisch (isoliert) oder gemeinsamVollständiger Hauptsitzungskontext
AufgabenaufzeichnungenImmer erstelltNie erstellt
ZustellungKanal, Webhook oder stillInline in der Hauptsitzung
Am besten fürBerichte, Erinnerungen, HintergrundjobsPosteingangsprüfungen, Kalender, Benachrichtigungen
Verwenden Sie geplante Aufgaben (Cron), wenn Sie präzise Zeitsteuerung oder isolierte Ausführung benötigen. Verwenden Sie Heartbeat, wenn die Arbeit vom vollständigen Sitzungskontext profitiert und ein ungefährer Zeitpunkt ausreicht.

Kernkonzepte

Geplante Aufgaben (cron)

Cron ist der integrierte Scheduler des Gateways für präzise Zeitsteuerung. Er speichert Jobs dauerhaft, weckt den Agenten zur richtigen Zeit und kann Ausgaben an einen Chat-Kanal oder Webhook-Endpunkt zustellen. Unterstützt einmalige Erinnerungen, wiederkehrende Ausdrücke und eingehende Webhook-Trigger. Siehe Geplante Aufgaben.

Aufgaben

Das Hintergrundaufgabenbuch verfolgt alle abgekoppelten Arbeiten: ACP-Läufe, Subagent-Starts, isolierte Cron-Ausführungen und CLI-Operationen. Aufgaben sind Aufzeichnungen, keine Scheduler. Verwenden Sie openclaw tasks list und openclaw tasks audit, um sie zu prüfen. Siehe Hintergrundaufgaben.

Abgeleitete Zusagen

Zusagen sind optionale, kurzlebige Nachverfolgungserinnerungen. OpenClaw leitet sie aus normalen Gesprächen ab, begrenzt sie auf denselben Agenten und Kanal und stellt fällige Check-ins über Heartbeat zu. Exakte, vom Benutzer angeforderte Erinnerungen gehören weiterhin zu Cron. Siehe Abgeleitete Zusagen.

Task Flow

Task Flow ist die Flow-Orchestrierungsschicht über Hintergrundaufgaben. Es verwaltet dauerhafte mehrstufige Flows mit verwalteten und gespiegelten Sync-Modi, Revisionsverfolgung und openclaw tasks flow list|show|cancel zur Prüfung. Siehe Task Flow.

Ständige Anweisungen

Ständige Anweisungen geben dem Agenten dauerhafte Betriebsbefugnis für definierte Programme. Sie liegen in Workspace-Dateien (typischerweise AGENTS.md) und werden in jede Sitzung eingefügt. Kombinieren Sie sie mit Cron für zeitbasierte Durchsetzung. Siehe Ständige Anweisungen.

Hooks

Interne Hooks sind ereignisgesteuerte Skripte, die durch Lebenszyklusereignisse des Agenten (/new, /reset, /stop), Sitzungs-Compaction, Gateway-Start und Nachrichtenfluss ausgelöst werden. Sie werden automatisch aus Verzeichnissen erkannt und können mit openclaw hooks verwaltet werden. Für das Abfangen von Tool-Aufrufen im Prozess verwenden Sie Plugin-Hooks. Siehe Hooks.

Heartbeat

Heartbeat ist ein regelmäßiger Hauptsitzungs-Turn (standardmäßig alle 30 Minuten). Er bündelt mehrere Prüfungen (Posteingang, Kalender, Benachrichtigungen) in einem Agenten-Turn mit vollständigem Sitzungskontext. Heartbeat-Turns erstellen keine Aufgabenaufzeichnungen und verlängern nicht die Frische für tägliche oder inaktive Sitzungszurücksetzungen. Verwenden Sie HEARTBEAT.md für eine kleine Checkliste oder einen tasks:-Block, wenn Sie fälligkeitsbasierte regelmäßige Prüfungen innerhalb von Heartbeat selbst möchten. Leere Heartbeat-Dateien werden mit empty-heartbeat-file übersprungen; der fälligkeitsbasierte Aufgabenmodus wird mit no-tasks-due übersprungen. Heartbeats werden verschoben, solange Cron-Arbeit aktiv oder in der Warteschlange ist, und heartbeat.skipWhenBusy kann einen Agenten auch verschieben, während die sitzungsschlüsselgebundenen Subagent- oder verschachtelten Lanes desselben Agenten ausgelastet sind. Siehe Heartbeat.

Wie sie zusammenarbeiten

  • Cron verarbeitet präzise Zeitpläne (tägliche Berichte, wöchentliche Reviews) und einmalige Erinnerungen. Alle Cron-Ausführungen erstellen Aufgabenaufzeichnungen.
  • Heartbeat verarbeitet routinemäßiges Monitoring (Posteingang, Kalender, Benachrichtigungen) in einem gebündelten Turn alle 30 Minuten.
  • Hooks reagieren mit benutzerdefinierten Skripten auf bestimmte Ereignisse (Sitzungszurücksetzungen, Compaction, Nachrichtenfluss). Plugin-Hooks decken Tool-Aufrufe ab.
  • Ständige Anweisungen geben dem Agenten dauerhaften Kontext und Befugnisgrenzen.
  • Task Flow koordiniert mehrstufige Flows über einzelnen Aufgaben.
  • Aufgaben verfolgen automatisch alle abgekoppelten Arbeiten, damit Sie sie prüfen und auditieren können.

Verwandt