Przejdź do głównej treści

Automatyzacja i zadania

OpenClaw uruchamia pracę w tle za pomocą zadań, zaplanowanych zadań, hooków zdarzeń i stałych instrukcji. Ta strona pomaga wybrać odpowiedni mechanizm i zrozumieć, jak są ze sobą powiązane.

Szybki przewodnik decyzyjny

Przypadek użyciaZalecaneDlaczego
Wysyłaj codzienny raport dokładnie o 9:00Zaplanowane zadania (Cron)Dokładny czas, odizolowane wykonanie
Przypomnij mi za 20 minutZaplanowane zadania (Cron)Jednorazowe z precyzyjnym czasem (--at)
Uruchamiaj cotygodniową dogłębną analizęZaplanowane zadania (Cron)Samodzielne zadanie, może używać innego modelu
Sprawdzaj skrzynkę odbiorczą co 30 minHeartbeatGrupuje się z innymi sprawdzeniami, świadome kontekstu
Monitoruj kalendarz pod kątem nadchodzących wydarzeńHeartbeatNaturalne dopasowanie do okresowej kontroli
Sprawdzaj stan subagenta lub przebiegu ACPZadania w tleRejestr zadań śledzi całą odłączoną pracę
Audytuj, co zostało uruchomione i kiedyZadania w tleopenclaw tasks list i openclaw tasks audit
Wieloetapowe badanie, a potem podsumowanieTask FlowTrwała orkiestracja ze śledzeniem wersji
Uruchom skrypt przy resecie sesjiHookiSterowane zdarzeniami, uruchamiane przy zdarzeniach cyklu życia
Wykonuj kod przy każdym wywołaniu narzędziaHookiHooki mogą filtrować według typu zdarzenia
Zawsze sprawdzaj zgodność przed odpowiedziąStanding OrdersAutomatycznie wstrzykiwane do każdej sesji

Zaplanowane zadania (Cron) a Heartbeat

WymiarZaplanowane zadania (Cron)Heartbeat
CzasDokładny (wyrażenia cron, jednorazowe)Przybliżony (domyślnie co 30 min)
Kontekst sesjiŚwieży (odizolowany) lub współdzielonyPełny kontekst głównej sesji
Rekordy zadańTworzone zawszeNigdy nie są tworzone
DostarczanieKanał, webhook lub po cichuBezpośrednio w głównej sesji
Najlepsze doRaportów, przypomnień, zadań w tleSprawdzania skrzynki, kalendarza, powiadomień
Używaj zaplanowanych zadań (Cron), gdy potrzebujesz precyzyjnego czasu lub odizolowanego wykonania. Używaj Heartbeat, gdy zadanie korzysta z pełnego kontekstu sesji i przybliżony czas jest wystarczający.

Podstawowe pojęcia

Zaplanowane zadania (cron)

Cron to wbudowany harmonogram Gateway służący do precyzyjnego planowania czasu. Utrwala zadania, wybudza agenta we właściwym momencie i może dostarczać wynik do kanału czatu lub punktu końcowego webhooka. Obsługuje jednorazowe przypomnienia, wyrażenia cykliczne i przychodzące wyzwalacze webhooków. Zobacz Scheduled Tasks.

Zadania

Rejestr zadań w tle śledzi całą odłączoną pracę: przebiegi ACP, uruchomienia subagentów, odizolowane wykonania cron i operacje CLI. Zadania to rekordy, a nie harmonogramy. Użyj openclaw tasks list i openclaw tasks audit, aby je sprawdzać. Zobacz Background Tasks.

Task Flow

Task Flow to warstwa orkiestracji przepływów ponad zadaniami w tle. Zarządza trwałymi wieloetapowymi przepływami z zarządzanymi i lustrzanymi trybami synchronizacji, śledzeniem wersji oraz openclaw tasks flow list|show|cancel do ich sprawdzania. Zobacz Task Flow.

Standing Orders

Standing Orders przyznają agentowi stałe uprawnienia operacyjne dla zdefiniowanych programów. Znajdują się w plikach przestrzeni roboczej (zwykle AGENTS.md) i są wstrzykiwane do każdej sesji. Połącz je z cron, aby wymuszać działania zależne od czasu. Zobacz Standing Orders.

Hooki

Hooki to skrypty sterowane zdarzeniami, wyzwalane przez zdarzenia cyklu życia agenta (/new, /reset, /stop), kompaktowanie sesji, uruchamianie gateway, przepływ wiadomości i wywołania narzędzi. Hooki są automatycznie wykrywane z katalogów i można nimi zarządzać za pomocą openclaw hooks. Zobacz Hooks.

Heartbeat

Heartbeat to okresowy obrót głównej sesji (domyślnie co 30 minut). Grupuje wiele kontroli (skrzynka odbiorcza, kalendarz, powiadomienia) w jednym obrocie agenta z pełnym kontekstem sesji. Obroty Heartbeat nie tworzą rekordów zadań. Używaj HEARTBEAT.md dla krótkiej listy kontrolnej albo bloku tasks:, gdy chcesz wykonywać tylko okresowe kontrole z terminem w samym heartbeat. Puste pliki heartbeat są pomijane jako empty-heartbeat-file; tryb zadań tylko-z-terminem jest pomijany jako no-tasks-due. Zobacz Heartbeat.

Jak to działa razem

  • Cron obsługuje precyzyjne harmonogramy (codzienne raporty, cotygodniowe przeglądy) i jednorazowe przypomnienia. Wszystkie wykonania cron tworzą rekordy zadań.
  • Heartbeat obsługuje rutynowe monitorowanie (skrzynka odbiorcza, kalendarz, powiadomienia) w jednym zgrupowanym obrocie co 30 minut.
  • Hooki reagują na określone zdarzenia (wywołania narzędzi, resety sesji, kompaktowanie) za pomocą niestandardowych skryptów.
  • Standing Orders zapewniają agentowi trwały kontekst i granice uprawnień.
  • Task Flow koordynuje wieloetapowe przepływy ponad pojedynczymi zadaniami.
  • Zadania automatycznie śledzą całą odłączoną pracę, aby można ją było sprawdzać i audytować.

Powiązane