Task Flow w OpenClaw — orkiestracja przeplywow pracy

Czym jest Task Flow?

Task Flow to warstwa orkiestracji przeplywow pracy, ktora dziala ponad zadaniami w tle (background tasks). Zapewnia trwale zarzadzanie wieloetapowymi przepływami z persystencja stanu i sledzeniem rewizji. Mozesz traktowac Task Flow jako «dyrygenta», ktory koordynuje wiele zadan w ramach jednego, spojnego procesu.

Kiedy uzywac Task Flow?

Dokumentacja jasno okresla cztery scenariusze:

• Pojedyncze zadanie w tle — uzyj zwyklych Tasks (bez Task Flow).
• Wieloetapowy potok (pipeline) — uzyj Task Flow w trybie managed.
• Obserwacja zewnetrznych zadan — uzyj Task Flow w trybie mirrored.
• Jednorazowe przypomnienie — uzyj zadan Cron.

Tryb zarzadzany (Managed)

W trybie managed Task Flow posiada cykl zycia od poczatku do konca. System tworzy zadania jako kroki przeplywu, prowadzi je do zakonczenia i automatycznie przesuwa stan przeplywu. Przyklad: tygodniowy raport realizowany w trzech kolejnych etapach:

Flow: Tygodniowy raport
  Krok 1: Zbieranie danych z API
  Krok 2: Generowanie analizy
  Krok 3: Wyslanie raportu na kanal

Kazdy krok jest osobnym zadaniem w tle, ale Task Flow automatycznie uruchamia nastepny krok po zakonczeniu poprzedniego. Jesli krok sie nie powiedzie, przeplyw moze ponowic probe lub zatrzymac sie w oczekiwaniu na interwencje.

Tryb lustrzany (Mirrored)

W trybie mirrored Task Flow obserwuje zewnetrznie utworzone zadania i utrzymuje stan przeplywu w synchronizacji — bez przejmowania odpowiedzialnosci za tworzenie zadan. Jest to przydatne, gdy zadania pochodza z zadan cron, komend CLI lub innych zrodel, a chcesz miec spojny widok postepow.

Kluczowe cechy

• Trwala persystencja stanu — stan przeplywu przetrwa restarty Gateway. Nawet jesli system zostanie uruchomiony ponownie, przeplyw wznowi sie od ostatniego znanego kroku.
• Sledzenie rewizji — mechanizm wykrywania konfliktow przy jednoczesnych aktualizacjach. Kazda zmiana stanu nosi numer rewizji, co zapobiega wysjcigom.
• Trwaly zamiar anulowania (sticky cancel) — po wyslaniu sygnalu anulowania, zamiar przetrwa restarty systemu. Nie ma ryzyka, ze restart «zapomni» o anulowaniu.

Komendy CLI

Trzy podstawowe komendy do zarzadzania przeplywami:

# Lista sledzonych przeplywow
openclaw tasks flow list

# Inspekcja konkretnego przeplywu
openclaw tasks flow show <lookup>

# Anulowanie dzialajacego przeplywu
openclaw tasks flow cancel <lookup>

Relacja do Tasks

Task Flow koordynuje zadania, nie zastepuje ich. Pojedynczy przeplyw moze zarzadzac wieloma zadaniami w tle w trakcie swojego cyklu zycia. Zadania (Tasks) pozostaja podstawowa jednostka pracy — Task Flow jedynie organizuje je w logiczne sekwencje i zapewnia, ze wykonuja sie we wlasciwej kolejnosci z odpowiednim przekazywaniem kontekstu.