Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw wykonuje pracę w tle za pomocą zadań, zaplanowanych zadań, wywnioskowanych zobowiązań, hooków zdarzeń i stałych poleceń. Ta strona pomaga wybrać właściwy mechanizm i zrozumieć, jak pasują do siebie.

​
Szybki przewodnik decyzyjny

Przypadek użyciaZalecaneDlaczego
Wyślij dzienny raport punktualnie o 9:00Zaplanowane zadania (Cron)Dokładny czas, izolowane wykonanie
Przypomnij mi za 20 minutZaplanowane zadania (Cron)Jednorazowe zadanie z precyzyjnym czasem (--at)
Uruchom cotygodniową głęboką analizęZaplanowane zadania (Cron)Samodzielne zadanie, może używać innego modelu
Sprawdzaj skrzynkę co 30 minHeartbeatGrupuje się z innymi kontrolami, uwzględnia kontekst
Monitoruj kalendarz pod kątem nadchodzących wydarzeńHeartbeatNaturalne dopasowanie do okresowej świadomości
Odezwij się po wspomnianej rozmowie kwalifikacyjnejWywnioskowane zobowiązaniaDalsze działanie podobne do pamięci, bez prośby o dokładne przypomnienie
Delikatny kontakt kontrolny wynikający z kontekstu użytkownikaWywnioskowane zobowiązaniaOgraniczone do tego samego agenta i kanału
Sprawdź status subagenta lub uruchomienia 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 podsumowaniePrzepływ zadańTrwała orkiestracja ze śledzeniem rewizji
Uruchom skrypt przy resecie sesjiHookiSterowane zdarzeniami, uruchamiane przy zdarzeniach cyklu życia
Wykonuj kod przy każdym wywołaniu narzędziaHooki PluginHooki wewnątrz procesu mogą przechwytywać wywołania narzędzi
Zawsze sprawdzaj zgodność przed odpowiedziąStałe poleceniaAutomatycznie wstrzykiwane do każdej sesji

​
Zaplanowane zadania (Cron) a Heartbeat

WymiarZaplanowane zadania (Cron)Heartbeat
Czas uruchomieniaDokładny (wyrażenia Cron, jednorazowe)Przybliżony (domyślnie co 30 min)
Kontekst sesjiNowy (izolowany) lub współdzielonyPełny kontekst sesji głównej
Rekordy zadańZawsze tworzoneNigdy nie są tworzone
DostarczenieKanał, Webhook lub tryb cichyW treści sesji głównej
Najlepsze doRaportów, przypomnień, zadań w tleKontroli skrzynki, kalendarza, powiadomień
Używaj Zaplanowanych zadań (Cron), gdy potrzebujesz precyzyjnego czasu lub izolowanego wykonania. Używaj Heartbeat, gdy praca korzysta z pełnego kontekstu sesji, a przybliżony harmonogram jest wystarczający.

​
Podstawowe pojęcia

​
Zaplanowane zadania (Cron)

Cron to wbudowany harmonogram Gateway do precyzyjnego ustalania czasu. Utrwala zadania, wybudza agenta we właściwym momencie i może dostarczać wynik do kanału czatu lub punktu końcowego Webhook. Obsługuje jednorazowe przypomnienia, powtarzalne wyrażenia i przychodzące wyzwalacze Webhook. Zobacz Zaplanowane zadania.

​
Zadania

Rejestr zadań w tle śledzi całą odłączoną pracę: uruchomienia ACP, utworzenia subagentów, izolowane wykonania Cron i operacje CLI. Zadania są rekordami, a nie harmonogramami. Używaj openclaw tasks list i openclaw tasks audit, aby je sprawdzać. Zobacz Zadania w tle.

​
Wywnioskowane zobowiązania

Zobowiązania to opcjonalne, krótkotrwałe pamięci działań następczych. OpenClaw wywnioskuje je ze zwykłych rozmów, ogranicza ich zakres do tego samego agenta i kanału oraz dostarcza należne kontakty kontrolne przez Heartbeat. Dokładne przypomnienia żądane przez użytkownika nadal należą do Cron. Zobacz Wywnioskowane zobowiązania.

​
Przepływ zadań

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

​
Stałe polecenia

Stałe polecenia nadają agentowi stałe uprawnienia operacyjne dla zdefiniowanych programów. Są przechowywane w plikach obszaru roboczego (zwykle AGENTS.md) i wstrzykiwane do każdej sesji. Łącz je z Cron, aby egzekwować je na podstawie czasu. Zobacz Stałe polecenia.

​
Hooki

Wewnętrzne hooki to skrypty sterowane zdarzeniami, wyzwalane przez zdarzenia cyklu życia agenta (/new, /reset, /stop), Compaction sesji, uruchomienie Gateway i przepływ wiadomości. Są automatycznie wykrywane w katalogach i można nimi zarządzać za pomocą openclaw hooks. Do przechwytywania wywołań narzędzi wewnątrz procesu użyj hooków Plugin. Zobacz Hooki.

​
Heartbeat

Heartbeat to okresowa tura sesji głównej (domyślnie co 30 minut). Grupuje wiele kontroli (skrzynka, kalendarz, powiadomienia) w jednej turze agenta z pełnym kontekstem sesji. Tury Heartbeat nie tworzą rekordów zadań i nie odświeżają ważności codziennego resetu sesji ani resetu po bezczynności. Użyj HEARTBEAT.md jako małej listy kontrolnej albo bloku tasks:, gdy chcesz wykonywać w samym Heartbeat okresowe kontrole tylko wtedy, gdy są należne. Puste pliki Heartbeat są pomijane jako empty-heartbeat-file; tryb zadań tylko po terminie jest pomijany jako no-tasks-due. Działania Heartbeat są odraczane, gdy praca Cron jest aktywna lub w kolejce, a heartbeat.skipWhenBusy może też odroczyć agenta, gdy subagent tego samego agenta powiązany kluczem sesji albo zagnieżdżone ścieżki są zajęte. Zobacz Heartbeat.

​
Jak działają razem

  • Cron obsługuje precyzyjne harmonogramy (dzienne raporty, cotygodniowe przeglądy) i jednorazowe przypomnienia. Wszystkie wykonania Cron tworzą rekordy zadań.
  • Heartbeat obsługuje rutynowe monitorowanie (skrzynka, kalendarz, powiadomienia) w jednej zgrupowanej turze co 30 minut.
  • Hooki reagują na konkretne zdarzenia (resety sesji, Compaction, przepływ wiadomości) za pomocą własnych skryptów. Hooki Plugin obejmują wywołania narzędzi.
  • Stałe polecenia dają agentowi trwały kontekst i granice uprawnień.
  • Przepływ zadań koordynuje wieloetapowe przepływy ponad pojedynczymi zadaniami.
  • Zadania automatycznie śledzą całą odłączoną pracę, aby można było ją sprawdzać i audytować.

​
Powiązane