Krótki przewodnik wyboru
Zaplanowane zadania (Cron) a Heartbeat
Używaj zaplanowanych zadań (Cron), gdy potrzebujesz precyzyjnego czasu lub izolowanego wykonania. Używaj Heartbeat, gdy praca korzysta z pełnego kontekstu sesji i wystarczy przybliżony czas wykonania.
Podstawowe pojęcia
Zaplanowane zadania (Cron)
Cron to wbudowany w Gateway harmonogram zapewniający precyzyjne wykonywanie zadań. Trwale przechowuje zadania, aktywuje agenta we właściwym czasie i może dostarczać wyniki do kanału czatu lub punktu końcowego webhooka. Obsługuje jednorazowe przypomnienia, cykliczne wyrażenia i wyzwalacze przychodzących webhooków. Zobacz Zaplanowane zadania.Zadania
Rejestr zadań w tle śledzi wszystkie odłączone prace: uruchomienia ACP, tworzenie subagentów, izolowane wykonania Cron i operacje CLI. Zadania są rekordami, a nie harmonogramami. Do ich sprawdzania używaj poleceńopenclaw tasks list i openclaw tasks audit.
Zobacz Zadania w tle.
Wywnioskowane zobowiązania
Zobowiązania to opcjonalne, krótkotrwałe wspomnienia o konieczności dalszego kontaktu. OpenClaw wywnioskuje je ze zwykłych rozmów, ogranicza do tego samego agenta i kanału oraz dostarcza zaplanowane sprawdzenia za pośrednictwem Heartbeat. Przypomnienia, o które użytkownik poprosił na konkretną porę, nadal należą do Cron. Zobacz Wywnioskowane zobowiązania.Przepływ zadań
Przepływ zadań to warstwa orkiestracji przepływów działająca nad zadaniami w tle. Zarządza trwałymi, wieloetapowymi przepływami z zarządzanymi i lustrzanymi trybami synchronizacji, śledzeniem wersji oraz poleceniamiopenclaw tasks flow list|show|cancel służącymi do ich sprawdzania.
Zobacz Przepływ zadań.
Stałe polecenia
Stałe polecenia przyznają agentowi trwałe uprawnienia operacyjne w ramach określonych programów. Znajdują się w plikach przestrzeni roboczej (zwykleAGENTS.md) i są wstrzykiwane do każdej sesji. Połącz je z Cron, aby wymuszać działania zależne od czasu.
Zobacz Stałe polecenia.
Hooki
Wewnętrzne hooki to skrypty sterowane zdarzeniami, uruchamiane przez zdarzenia cyklu życia agenta (/new, /reset, /stop), Compaction sesji, uruchomienie Gateway i przepływ
wiadomości. Są wykrywane w katalogach hooków i zarządzane za pomocą
openclaw hooks. Do przechwytywania wywołań narzędzi wewnątrz procesu używaj
hooków Pluginu.
Zobacz Hooki.
Heartbeat
Heartbeat to okresowa tura sesji głównej (domyślnie co 30 minut). Grupuje wiele kontroli (skrzynki odbiorczej, kalendarza i powiadomień) w jednej turze agenta z pełnym kontekstem sesji. Tury Heartbeat nie tworzą rekordów zadań ani nie przedłużają okresu świeżości przed dziennym resetem sesji lub resetem z powodu bezczynności. Użyj plikuHEARTBEAT.md jako krótkiej listy kontrolnej albo bloku tasks:, jeśli w samym Heartbeat chcesz wykonywać tylko okresowe kontrole, których termin już nadszedł. Puste pliki Heartbeat powodują pominięcie z kodem empty-heartbeat-file, a tryb zadań wykonywanych wyłącznie w terminie — z kodem no-tasks-due. Heartbeat jest odraczany, gdy praca Cron jest aktywna lub oczekuje w kolejce, a opcja heartbeat.skipWhenBusy może również odroczyć agenta, gdy powiązany z kluczem sesji subagent tego samego agenta lub jego zagnieżdżone ścieżki są zajęte.
Zobacz Heartbeat.
Jak współpracują
- Cron obsługuje precyzyjne harmonogramy (codzienne raporty, cotygodniowe przeglądy) i jednorazowe przypomnienia. Wszystkie wykonania Cron tworzą rekordy zadań.
- Heartbeat obsługuje rutynowe monitorowanie (skrzynki odbiorczej, kalendarza i powiadomień) w jednej zbiorczej turze co 30 minut.
- Hooki reagują na konkretne zdarzenia (resetowanie sesji, Compaction, przepływ wiadomości) za pomocą niestandardowych skryptów. Hooki Pluginu obejmują wywołania narzędzi.
- Stałe polecenia zapewniają agentowi trwały kontekst i granice uprawnień.
- Przepływ zadań koordynuje wieloetapowe przepływy ponad pojedynczymi zadaniami.
- Zadania automatycznie śledzą wszystkie odłączone prace, umożliwiając ich sprawdzanie i audytowanie.
Powiązane
- Zaplanowane zadania — precyzyjne planowanie i jednorazowe przypomnienia
- Wywnioskowane zobowiązania — dalsze kontakty przypominające działanie pamięci
- Zadania w tle — rejestr wszystkich odłączonych prac
- Przepływ zadań — trwała orkiestracja wieloetapowych przepływów
- Hooki — sterowane zdarzeniami skrypty cyklu życia
- Hooki Pluginu — działające wewnątrz procesu hooki narzędzi, promptów, wiadomości i cyklu życia
- Stałe polecenia — trwałe instrukcje agenta
- Heartbeat — okresowe tury sesji głównej
- Dokumentacja konfiguracji — wszystkie klucze konfiguracji