--- read_when: - Sie möchten verstehen, wie TaskFlow mit Hintergrundaufgaben zusammenhängt - Sie stoßen in Versionshinweisen oder der Dokumentation auf Task Flow oder openclaw tasks flow - Sie möchten persistenten Flow-Zustand prüfen oder verwalten summary: TaskFlow-Ablauforchestrierungsschicht oberhalb von Hintergrundaufgaben title: Aufgabenablauf x-i18n: generated_at: "2026-05-10T19:21:11Z" model: gpt-5.5 provider: openai source_hash: 135227b250840cd579f10a8ab4211e9319c447bb4d6df25907738ea138fc2d2a source_path: automation/taskflow.md workflow: 16 --- Task Flow ist die Flow-Orchestrierungsschicht oberhalb von [Hintergrundaufgaben](/de/automation/tasks). Sie verwaltet dauerhafte mehrstufige Flows mit eigenem Zustand, Revisionsverfolgung und Sync-Semantik, während einzelne Aufgaben die Einheit für losgelöste Arbeit bleiben. ## 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](/de/automation/tasks) 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: 1. Verwenden Sie [geplante Aufgaben](/de/automation/cron-jobs) für das Timing. 2. Verwenden Sie eine persistente Cron-Sitzung, wenn der Workflow auf vorherigem Kontext aufbauen soll. 3. Verwenden Sie [Lobster](/de/tools/lobster) für deterministische Schritte, Genehmigungsgates und Resume-Tokens. 4. Verwenden Sie Task Flow, um den mehrstufigen Lauf über untergeordnete Aufgaben, Wartezeiten, Wiederholungen und Gateway-Neustarts hinweg zu verfolgen. Beispielhafte Cron-Struktur: ```bash openclaw cron add \ --name "Market intelligence brief" \ --cron "0 7 * * 1-5" \ --tz "America/New_York" \ --session session:market-intel \ --message "Run the market-intel Lobster workflow. Verify source freshness before summarizing." \ --announce \ --channel slack \ --to "channel:C1234567890" ``` Verwenden Sie `session:` 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: ```yaml name: market-intel-brief steps: - id: preflight command: market-intel check --json - id: collect command: market-intel collect --json stdin: $preflight.json - id: summarize command: market-intel summarize --json stdin: $collect.json - id: approve command: market-intel deliver --preview stdin: $summarize.json approval: required - id: deliver command: market-intel deliver --execute stdin: $summarize.json condition: $approve.approved ``` Empfohlene Preflight-Prüfungen: - Browserverfügbarkeit und Profilauswahl, zum Beispiel `openclaw` für verwalteten Zustand oder `user`, wenn eine angemeldete Chrome-Sitzung erforderlich ist. Siehe [Browser](/de/tools/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`, `browser` und `llm-task`. - Fehlerziel für Cron konfiguriert, damit Preflight-Fehler sichtbar sind. Siehe [geplante Aufgaben](/de/automation/cron-jobs#delivery-and-output). Empfohlene Datenherkunftsfelder für jedes erfasste Element: ```json { "sourceUrl": "https://example.com/report", "retrievedAt": "2026-04-24T12:00:00Z", "asOf": "2026-04-24", "title": "Example report", "content": "..." } ``` Lassen Sie den Workflow veraltete Elemente vor der Zusammenfassung ablehnen oder markieren. Der LLM-Schritt sollte nur strukturiertes JSON erhalten und angewiesen werden, `sourceUrl`, `retrievedAt` und `asOf` in seiner Ausgabe beizubehalten. Verwenden Sie [LLM Task](/de/tools/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](/de/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. ``` Flow: weekly-report Step 1: gather-data → task created → succeeded Step 2: generate-report → task created → succeeded Step 3: deliver → task created → running ``` ### 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 unbegrenzten `registry.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 ```bash # List active and recent flows openclaw tasks flow list # Show details for a specific flow openclaw tasks flow show # Cancel a running flow and its active tasks openclaw tasks flow cancel ``` | Befehl | Beschreibung | | -------------------------------- | ------------------------------------------------- | | `openclaw tasks flow list` | Zeigt verfolgte Flows mit Status und Sync-Modus | | `openclaw tasks flow show ` | Einen Flow nach Flow-ID oder Lookup-Schlüssel prüfen | | `openclaw tasks flow cancel ` | 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 Sie `openclaw tasks`, um einzelne Aufgabendatensätze zu prüfen, und `openclaw tasks flow`, um den orchestrierenden Flow zu prüfen. ## Verwandt - [Hintergrundaufgaben](/de/automation/tasks) — das Register für losgelöste Arbeit, das Flows koordinieren - [CLI: Aufgaben](/de/cli/tasks) — CLI-Befehlsreferenz für `openclaw tasks flow` - [Automatisierungsübersicht](/de/automation) — alle Automatisierungsmechanismen auf einen Blick - [Cron-Jobs](/de/automation/cron-jobs) — geplante Jobs, die in Flows einfließen können