Task Flow ist die Flow-Orchestrierungsschicht oberhalb von Hintergrundaufgaben. Sie verwaltet dauerhafte mehrstufige Flows mit eigenem Zustand, Revisionsverfolgung und Sync-Semantik, während einzelne Aufgaben die Einheit für losgelöste Arbeit bleiben.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.
Wann Sie Task Flow verwenden sollten
Verwenden Sie Task Flow, wenn Arbeit mehrere sequenzielle oder verzweigte Schritte umfasst und Sie eine dauerhafte Fortschrittsverfolgung über Gateway-Neustarts hinweg benötigen. Für einzelne Hintergrundvorgänge reicht eine einfache Aufgabe aus.| Szenario | Verwendung |
|---|---|
| Einzelner Hintergrundjob | Einfache Aufgabe |
| Mehrstufige Pipeline (A dann B dann C) | Task Flow (verwaltet) |
| Extern erstellte Aufgaben beobachten | Task Flow (gespiegelt) |
| Einmalige Erinnerung | Cron-Job |
Zuverlässiges Muster für geplante Workflows
Für wiederkehrende Workflows wie Marktanalyse-Briefings behandeln Sie Zeitplanung, Orchestrierung und Zuverlässigkeitsprüfungen als getrennte Ebenen:- Verwenden Sie geplante Aufgaben für das Timing.
- Verwenden Sie eine persistente Cron-Sitzung, wenn der Workflow auf vorherigem Kontext aufbauen soll.
- Verwenden Sie Lobster für deterministische Schritte, Genehmigungsgates und Resume-Tokens.
- Verwenden Sie Task Flow, um den mehrstufigen Lauf über untergeordnete Aufgaben, Wartezeiten, Wiederholungen und Gateway-Neustarts hinweg zu verfolgen.
session:<id> anstelle von isolated, wenn der wiederkehrende Workflow bewusst Historie, Zusammenfassungen vorheriger Läufe oder dauerhaft vorhandenen Kontext benötigt. Verwenden Sie isolated, wenn jeder Lauf frisch starten soll und der gesamte erforderliche Zustand explizit im Workflow enthalten ist.
Platzieren Sie im Workflow Zuverlässigkeitsprüfungen vor dem LLM-Zusammenfassungsschritt:
- Browserverfügbarkeit und Profilauswahl, zum Beispiel
openclawfür verwalteten Zustand oderuser, wenn eine angemeldete Chrome-Sitzung erforderlich ist. Siehe Browser. - API-Zugangsdaten und Kontingent für jede Quelle.
- Netzwerkerreichbarkeit für erforderliche Endpunkte.
- Erforderliche Tools, die für den Agenten aktiviert sind, wie
lobster,browserundllm-task. - Fehlerziel für Cron konfiguriert, damit Preflight-Fehler sichtbar sind. Siehe geplante Aufgaben.
sourceUrl, retrievedAt und asOf in seiner Ausgabe beizubehalten. Verwenden Sie LLM Task, wenn Sie einen schemavalidierten Modellschritt im Workflow benötigen.
Für wiederverwendbare Team- oder Community-Workflows verpacken Sie die CLI, .lobster-Dateien und alle Einrichtungshinweise als Skill oder Plugin und veröffentlichen Sie sie über ClawHub. Bewahren Sie Workflow-spezifische Leitplanken in diesem Paket auf, sofern der Plugin-API keine benötigte generische Fähigkeit fehlt.
Sync-Modi
Verwalteter Modus
Task Flow besitzt den gesamten Lebenszyklus. Es erstellt Aufgaben als Flow-Schritte, führt sie bis zum Abschluss und setzt den Flow-Zustand automatisch fort. Beispiel: ein wöchentlicher Berichts-Flow, der (1) Daten sammelt, (2) den Bericht erzeugt und (3) ihn ausliefert. Task Flow erstellt jeden Schritt als Hintergrundaufgabe, wartet auf den Abschluss und wechselt dann zum nächsten Schritt.Gespiegelter Modus
Task Flow beobachtet extern erstellte Aufgaben und hält den Flow-Zustand synchron, ohne die Erstellung der Aufgaben zu übernehmen. Dies ist nützlich, wenn Aufgaben aus Cron-Jobs, CLI-Befehlen oder anderen Quellen stammen und Sie eine einheitliche Ansicht ihres Fortschritts als Flow möchten. Beispiel: drei unabhängige Cron-Jobs, die zusammen eine „morning ops“-Routine bilden. Ein gespiegelter Flow verfolgt ihren gemeinsamen Fortschritt, ohne zu steuern, wann oder wie sie ausgeführt werden.Dauerhafter Zustand und Revisionsverfolgung
Jeder Flow persistiert seinen eigenen Zustand und verfolgt Revisionen, damit der Fortschritt Gateway-Neustarts übersteht. Die Revisionsverfolgung ermöglicht Konflikterkennung, wenn mehrere Quellen gleichzeitig versuchen, denselben Flow fortzusetzen. Die Flow-Registry verwendet SQLite mit begrenzter Write-Ahead-Log-Wartung, einschließlich periodischer und Shutdown-Checkpoints, sodass langfristig laufende Gateways keine unbegrenztenregistry.sqlite-wal-Sidecar-Dateien behalten.
Abbruchverhalten
openclaw tasks flow cancel setzt eine dauerhafte Abbruchabsicht für den Flow. Aktive Aufgaben innerhalb des Flows werden abgebrochen, und es werden keine neuen Schritte gestartet. Die Abbruchabsicht bleibt über Neustarts hinweg bestehen, sodass ein abgebrochener Flow abgebrochen bleibt, selbst wenn das Gateway neu startet, bevor alle untergeordneten Aufgaben beendet wurden.
CLI-Befehle
| Befehl | Beschreibung |
|---|---|
openclaw tasks flow list | Zeigt verfolgte Flows mit Status und Sync-Modus |
openclaw tasks flow show <id> | Einen Flow nach Flow-ID oder Lookup-Schlüssel prüfen |
openclaw tasks flow cancel <id> | Einen laufenden Flow und seine aktiven Aufgaben abbrechen |
Wie Flows mit Aufgaben zusammenhängen
Flows koordinieren Aufgaben, ersetzen sie aber nicht. Ein einzelner Flow kann im Laufe seiner Lebensdauer mehrere Hintergrundaufgaben steuern. Verwenden Sieopenclaw tasks, um einzelne Aufgabendatensätze zu prüfen, und openclaw tasks flow, um den orchestrierenden Flow zu prüfen.
Verwandt
- Hintergrundaufgaben — das Register für losgelöste Arbeit, das Flows koordinieren
- CLI: Aufgaben — CLI-Befehlsreferenz für
openclaw tasks flow - Automatisierungsübersicht — alle Automatisierungsmechanismen auf einen Blick
- Cron-Jobs — geplante Jobs, die in Flows einfließen können