Zadania w tle (Tasks) w OpenClaw — sledzenie i audyt

Czym sa zadania w tle?

Zadania w tle (Background Tasks) sledzac prace, ktora wykonuje sie poza glowna sesja konwersacyjna. Obejmuja uruchomienia ACP, spawny subagentow, izolowane wykonania cron i operacje CLI. Wazne: Tasks to rekordy aktywnosci, nie schedulery — dokumentuja, jaka odlaczona praca miala miejsce, kiedy i z jakim wynikiem.

Co tworzy zadania?

Rozne typy uruchomien generuja rekordy zadan:

• Uruchomienia ACP w tle — runtime: acp
• Orkiestracja subagentow — runtime: subagent
• Wszystkie wykonania cron — runtime: cron
• Operacje CLI — runtime: cli
• Zadania generowania mediow — wspierane przez sesje

Co NIE tworzy zadan?

Nie wszystkie aktywnosci generuja rekordy. Zadania nie sa tworzone przez:

• Obroty heartbeat (te sa czescia glownej sesji).
• Normalny interaktywny czat z agentem.
• Bezposrednie odpowiedzi na polecenia (synchroniczne komendy).

Cykl zycia zadania

Kazde zadanie przechodzi przez serie stanow:

queued → running → [stan koncowy]

Stany koncowe:
  ✅ succeeded  — zadanie zakonczono pomyslnie
  ❌ failed     — zadanie zakonczylo sie bledem
  ⏰ timed_out  — przekroczono limit czasu
  🚫 cancelled  — zadanie zostalo anulowane
  👻 lost       — runtime wspierajacy zniknal na 5+ minut

Stan lost wystepuje, gdy backing runtime (np. proces subagenta) przestaje odpowiadac przez ponad 5 minut. Jest to sygnal, ze cos poszlo nie tak na poziomie infrastruktury.

Polityki powiadomien

Mozesz kontrolowac, jak agent informuje o postepach zadania:

• done_only (domyslne) — powiadomienie tylko po osiagnieciu stanu koncowego. Minimalne szum informacyjny.
• state_changes — powiadomienie przy kazdym przejsciu stanu i aktualizacji postepu. Przydatne do debugowania.
• silent — brak powiadomien. Zadanie wykonuje sie cicho, wynik mozna sprawdzic recznie.

Mechanizmy dostarczania

Zakonczenie zadania uzywa dostarczania typu push:

• Bezposrednie powiadomienie na kanal — wynik pojawia sie na czacie.
• Kolejkowanie jako zdarzenie systemowe — wynik jest umieszczany w sesji zleceniodawcy i pojawi sie przy nastepnym obrocie heartbeat.

Dzieki temu nie musisz aktywnie odpytywac o status — system sam Cie powiadomi.

Komendy CLI

Podstawowe operacje do zarzadzania zadaniami:

# Lista zadan (z filtrami stanu)
openclaw tasks list
openclaw tasks list --state running

# Szczegoly zadania
openclaw tasks show <taskId>

# Anuluj zadanie
openclaw tasks cancel <taskId>

# Zmien politeke powiadomien
openclaw tasks notify <taskId> --policy state_changes

# Audyt — historia i statystyki
openclaw tasks audit

# Konserwacja — czyszczenie i zdrowie
openclaw tasks maintenance

Retencja danych

Rekordy zadan w stanach koncowych sa automatycznie czyszczone po 7 dniach. Oznacza to, ze masz tygodniowe okno na przegladanie historii i przeprowadzanie audytow. Jesli potrzebujesz dluzszej retencji, rozważ eksport danych za pomoca komendy openclaw tasks audit przed wygasnieciem rekordow.