Automation and tasks
Automatisierung und Aufgaben
OpenClaw führt Arbeit im Hintergrund über Aufgaben, geplante Jobs, abgeleitete Commitments, Event-Hooks und dauerhafte Anweisungen aus. Diese Seite hilft Ihnen, den richtigen Mechanismus auszuwählen und zu verstehen, wie sie zusammenpassen.
Schnelle Entscheidungshilfe
flowchart TD
START([What do you need?]) --> Q1{Schedule work?}
START --> Q2{Track detached work?}
START --> Q3{Orchestrate multi-step flows?}
START --> Q4{React to lifecycle events?}
START --> Q5{Give the agent persistent instructions?}
START --> Q6{Remember a natural follow-up?}
Q1 -->|Yes| Q1a{Exact timing or flexible?}
Q1a -->|Exact| CRON["Scheduled Tasks (Cron)"]
Q1a -->|Flexible| HEARTBEAT[Heartbeat]
Q2 -->|Yes| TASKS[Background Tasks]
Q3 -->|Yes| FLOW[Task Flow]
Q4 -->|Yes| HOOKS[Hooks]
Q5 -->|Yes| SO[Standing Orders]
Q6 -->|Yes| COMMITMENTS[Inferred Commitments]
| Anwendungsfall | Empfehlung | Warum |
|---|---|---|
| Täglichen Bericht genau um 9 Uhr senden | Geplante Aufgaben (Cron) | Exakter Zeitpunkt, isolierte Ausführung |
| Erinnern Sie mich in 20 Minuten | Geplante Aufgaben (Cron) | Einmalig mit präzisem Zeitpunkt (--at) |
| Wöchentliche Tiefenanalyse ausführen | Geplante Aufgaben (Cron) | Eigenständige Aufgabe, kann anderes Modell verwenden |
| Posteingang alle 30 Minuten prüfen | Heartbeat | Wird mit anderen Prüfungen gebündelt, kontextbewusst |
| Kalender auf bevorstehende Ereignisse überwachen | Heartbeat | Natürliche Passung für periodische Awareness |
| Nach einem erwähnten Interview nachfassen | Abgeleitete Commitments | Gedächtnisähnliches Nachfassen, keine exakte Erinnerung |
| Dezenter Care-Check-in nach Benutzerkontext | Abgeleitete Commitments | Auf denselben Agenten und Kanal beschränkt |
| Status eines Subagenten oder ACP-Laufs prüfen | Hintergrundaufgaben | Aufgabenbuch zeichnet alle losgelösten Arbeiten auf |
| Prüfen, was wann ausgeführt wurde | Hintergrundaufgaben | openclaw tasks list und openclaw tasks audit |
| Mehrstufig recherchieren und dann zusammenfassen | Task Flow | Dauerhafte Orchestrierung mit Revisionsverfolgung |
| Skript beim Sitzungs-Reset ausführen | Hooks | Eventgesteuert, wird bei Lebenszyklusereignissen ausgelöst |
| Code bei jedem Tool-Aufruf ausführen | Plugin-Hooks | In-Process-Hooks können Tool-Aufrufe abfangen |
| Vor Antworten immer Compliance prüfen | Dauerhafte Anweisungen | Wird automatisch in jede Sitzung injiziert |
Geplante Aufgaben (Cron) vs. Heartbeat
| Dimension | Geplante Aufgaben (Cron) | Heartbeat |
|---|---|---|
| Zeitpunkt | Exakt (Cron-Ausdrücke, einmalig) | Ungefähr (standardmäßig alle 30 Min.) |
| Sitzungskontext | Frisch (isoliert) oder gemeinsam | Voller Kontext der Hauptsitzung |
| Aufgabendatensätze | Immer erstellt | Nie erstellt |
| Zustellung | Kanal, Webhook oder still | Inline in der Hauptsitzung |
| Am besten für | Berichte, Erinnerungen, Hintergrundjobs | Posteingangsprüfungen, Kalender, Benachrichtigungen |
Verwenden Sie Geplante Aufgaben (Cron), wenn Sie präzises Timing oder isolierte Ausführung benötigen. Verwenden Sie Heartbeat, wenn die Arbeit vom vollständigen Sitzungskontext profitiert und ungefähres Timing ausreicht.
Kernkonzepte
Geplante Aufgaben (Cron)
Cron ist der integrierte Scheduler des Gateway für präzises Timing. Er persistiert Jobs, weckt den Agenten zum richtigen Zeitpunkt und kann Ausgaben an einen Chatkanal oder Webhook-Endpunkt zustellen. Unterstützt einmalige Erinnerungen, wiederkehrende Ausdrücke und eingehende Webhook-Auslöser.
Siehe Geplante Aufgaben.
Aufgaben
Das Hintergrundaufgabenbuch verfolgt alle losgelösten Arbeiten: ACP-Läufe, Subagent-Starts, isolierte Cron-Ausführungen und CLI-Operationen. Aufgaben sind Datensätze, keine Scheduler. Verwenden Sie openclaw tasks list und openclaw tasks audit, um sie zu prüfen.
Siehe Hintergrundaufgaben.
Abgeleitete Commitments
Commitments sind optionale, kurzlebige Nachfass-Erinnerungen. OpenClaw leitet sie aus normalen Gesprächen ab, beschränkt 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 Commitments.
Task Flow
Task Flow ist das Substrat für Flow-Orchestrierung oberhalb von 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.
Dauerhafte Anweisungen
Dauerhafte Anweisungen geben dem Agenten permanente Betriebsautorität für definierte Programme. Sie liegen in Workspace-Dateien (typischerweise AGENTS.md) und werden in jede Sitzung injiziert. Kombinieren Sie sie mit Cron für zeitbasierte Durchsetzung.
Siehe Dauerhafte Anweisungen.
Hooks
Interne Hooks sind eventgesteuerte 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 periodischer Turn der Hauptsitzung (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 Aufgabendatensätze und verlängern nicht die Frische für tägliche oder inaktive Sitzungs-Resets. Verwenden Sie HEARTBEAT.md für eine kleine Checkliste oder einen tasks:-Block, wenn Sie fälligkeitsbasierte periodische Prüfungen innerhalb von Heartbeat selbst möchten. Leere Heartbeat-Dateien werden als empty-heartbeat-file übersprungen; der fälligkeitsbasierte Aufgabenmodus wird als no-tasks-due übersprungen. Heartbeats werden aufgeschoben, während Cron-Arbeit aktiv ist oder in der Warteschlange steht, und heartbeat.skipWhenBusy kann sie ebenfalls aufschieben, während Subagenten- oder verschachtelte Lanes 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 Aufgabendatensätze.
- Heartbeat verarbeitet Routineüberwachung (Posteingang, Kalender, Benachrichtigungen) in einem gebündelten Turn alle 30 Minuten.
- Hooks reagieren mit benutzerdefinierten Skripten auf bestimmte Ereignisse (Sitzungs-Resets, Compaction, Nachrichtenfluss). Plugin-Hooks decken Tool-Aufrufe ab.
- Dauerhafte Anweisungen geben dem Agenten persistenten Kontext und Autoritätsgrenzen.
- Task Flow koordiniert mehrstufige Flows oberhalb einzelner Aufgaben.
- Aufgaben verfolgen automatisch alle losgelösten Arbeiten, damit Sie sie prüfen und auditieren können.
Verwandt
- Geplante Aufgaben — präzise Planung und einmalige Erinnerungen
- Abgeleitete Commitments — gedächtnisähnliche Nachfass-Check-ins
- Hintergrundaufgaben — Aufgabenbuch für alle losgelösten Arbeiten
- Task Flow — dauerhafte mehrstufige Flow-Orchestrierung
- Hooks — eventgesteuerte Lebenszyklus-Skripte
- Plugin-Hooks — In-Process-Hooks für Tools, Prompts, Nachrichten und Lebenszyklus
- Dauerhafte Anweisungen — persistente Agentenanweisungen
- Heartbeat — periodische Turns der Hauptsitzung
- Konfigurationsreferenz — alle Konfigurationsschlüssel