​

Cron vs Heartbeat: Kiedy używać którego

​

Szybki przewodnik decyzyjny

​

Heartbeat: Okresowa świadomość

​

Kiedy używać heartbeat

• Wiele okresowych sprawdzeń: Zamiast 5 oddzielnych zadań cron sprawdzających skrzynkę, kalendarz, pogodę, powiadomienia i status projektu, pojedynczy heartbeat może zgrupować je wszystkie.
• Decyzje świadome kontekstu: Agent ma pełny kontekst głównej sesji, więc potrafi rozsądnie zdecydować, co jest pilne, a co może poczekać.
• Ciągłość konwersacji: Uruchomienia heartbeat współdzielą tę samą sesję, więc agent pamięta ostatnie rozmowy i może naturalnie nawiązywać.
• Monitorowanie o niskim narzucie: Jeden heartbeat zastępuje wiele drobnych zadań odpytywania.

​

Zalety heartbeat

• Grupuje wiele sprawdzeń: Jedna tura agenta może jednocześnie przejrzeć skrzynkę, kalendarz i powiadomienia.
• Redukuje wywołania API: Pojedynczy heartbeat jest tańszy niż 5 izolowanych zadań cron.
• Świadomy kontekstu: Agent wie, nad czym pracowałeś(-aś), i odpowiednio ustala priorytety.
• Inteligentne tłumienie: Jeśli nic nie wymaga uwagi, agent odpowiada HEARTBEAT_OK i żadna wiadomość nie jest dostarczana.
• Naturalne wyczucie czasu: Niewielkie dryfowanie w zależności od obciążenia kolejki, co jest akceptowalne dla większości monitoringu.

​

Przykład heartbeat: lista kontrolna HEARTBEAT.md

# Heartbeat checklist

- Check email for urgent messages
- Review calendar for events in next 2 hours
- If a background task finished, summarize results
- If idle for 8+ hours, send a brief check-in

​

Konfiguracja heartbeat

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m", // interval
        target: "last", // where to deliver alerts
        activeHours: { start: "08:00", end: "22:00" }, // optional
      },
    },
  },
}

​

Cron: Precyzyjne planowanie

​

Kiedy używać cron

• Wymagana dokładna godzina: „Wyślij to w każdy poniedziałek o 9:00” (a nie „gdzieś około 9”).
• Zadania samodzielne: Zadania, które nie wymagają kontekstu konwersacyjnego.
• Inny model/sposób myślenia: Ciężka analiza, która uzasadnia użycie potężniejszego modelu.
• Jednorazowe przypomnienia: „Przypomnij za 20 minut” z --at.
• Głośne/częste zadania: Zadania, które zaśmiecałyby historię głównej sesji.
• Wyzwalacze zewnętrzne: Zadania, które powinny działać niezależnie od aktywności agenta.

​

Zalety cron

• Dokładny czas: 5-polowe wyrażenia cron z obsługą stref czasowych.
• Izolacja sesji: Uruchamia się w cron:<jobId> bez zanieczyszczania głównej historii.
• Nadpisywanie modelu: Możliwość użycia tańszego lub potężniejszego modelu dla zadania.
• Kontrola dostarczania: Zadania izolowane domyślnie używają announce (podsumowanie); w razie potrzeby wybierz none.
• Natychmiastowe dostarczenie: Tryb announce publikuje bezpośrednio, bez czekania na heartbeat.
• Brak potrzeby kontekstu agenta: Działa nawet, gdy główna sesja jest bezczynna lub skompaktowana.
• Obsługa jednorazowa: --at dla precyzyjnych przyszłych znaczników czasu.

​

Przykład cron: Codzienny poranny briefing

openclaw cron add \
  --name "Morning briefing" \
  --cron "0 7 * * *" \
  --tz "America/New_York" \
  --session isolated \
  --message "Generate today's briefing: weather, calendar, top emails, news summary." \
  --model opus \
  --announce \
  --channel whatsapp \
  --to "+15551234567"

​

Przykład cron: Jednorazowe przypomnienie

openclaw cron add \
  --name "Meeting reminder" \
  --at "20m" \
  --session main \
  --system-event "Reminder: standup meeting starts in 10 minutes." \
  --wake now \
  --delete-after-run

​

Schemat podejmowania decyzji

Does the task need to run at an EXACT time?
  YES -> Use cron
  NO  -> Continue...

Does the task need isolation from main session?
  YES -> Use cron (isolated)
  NO  -> Continue...

Can this task be batched with other periodic checks?
  YES -> Use heartbeat (add to HEARTBEAT.md)
  NO  -> Use cron

Is this a one-shot reminder?
  YES -> Use cron with --at
  NO  -> Continue...

Does it need a different model or thinking level?
  YES -> Use cron (isolated) with --model/--thinking
  NO  -> Use heartbeat

​

Łączenie obu

1. Heartbeat obsługuje rutynowy monitoring (skrzynka, kalendarz, powiadomienia) w jednej zgrupowanej turze co 30 minut.
2. Cron obsługuje precyzyjne harmonogramy (raporty dzienne, przeglądy tygodniowe) oraz jednorazowe przypomnienia.

​

Przykład: Efektywna konfiguracja automatyzacji

# Heartbeat checklist

- Scan inbox for urgent emails
- Check calendar for events in next 2h
- Review any pending tasks
- Light check-in if quiet for 8+ hours

# Daily morning briefing at 7am
openclaw cron add --name "Morning brief" --cron "0 7 * * *" --session isolated --message "..." --announce

# Weekly project review on Mondays at 9am
openclaw cron add --name "Weekly review" --cron "0 9 * * 1" --session isolated --message "..." --model opus

# One-shot reminder
openclaw cron add --name "Call back" --at "2h" --session main --system-event "Call back the client" --wake now

​

Lobster: Deterministyczne workflow z zatwierdzeniami

​

Kiedy Lobster pasuje

• Automatyzacja wielokrokowa: Potrzebujesz stałego potoku wywołań narzędzi, a nie jednorazowego promptu.
• Bramki zatwierdzeń: Efekty uboczne powinny się zatrzymać do czasu zatwierdzenia, a następnie wznowić.
• Wznawialne uruchomienia: Kontynuowanie wstrzymanego workflow bez ponownego wykonywania wcześniejszych kroków.

​

Jak współpracuje z heartbeat i cron

• Heartbeat/cron decydują, kiedy następuje uruchomienie.
• Lobster definiuje, jakie kroki zachodzą po rozpoczęciu uruchomienia.

​

Uwagi operacyjne (z kodu)

• Lobster działa jako lokalny podproces (CLI lobster) w trybie narzędzia i zwraca kopertę JSON.
• Jeśli narzędzie zwróci needs_approval, wznawiasz z resumeToken i flagą approve.
• Narzędzie jest opcjonalną wtyczką; włączaj je addytywnie przez tools.alsoAllow: ["lobster"] (zalecane).
• Jeśli przekażesz lobsterPath, musi to być ścieżka bezwzględna.

​

Główna sesja vs sesja izolowana

​

Kiedy używać cron w głównej sesji

• Aby przypomnienie/zdarzenie pojawiło się w kontekście głównej sesji
• Aby agent obsłużył je podczas następnego heartbeat z pełnym kontekstem
• Brak oddzielnego, izolowanego uruchomienia

openclaw cron add \
  --name "Check project" \
  --every "4h" \
  --session main \
  --system-event "Time for a project health check" \
  --wake now

​

Kiedy używać cron izolowanego

• Czysty łupek bez wcześniejszego kontekstu
• Inne ustawienia modelu lub sposobu myślenia
• Bezpośrednie ogłaszanie podsumowań na kanał
• Historię, która nie zaśmieca głównej sesji

openclaw cron add \
  --name "Deep analysis" \
  --cron "0 6 * * 0" \
  --session isolated \
  --message "Weekly codebase analysis..." \
  --model opus \
  --thinking high \
  --announce

​

Kwestie kosztowe

• Utrzymuj HEARTBEAT.md w niewielkim rozmiarze, aby zminimalizować narzut tokenów.
• Grupuj podobne sprawdzenia w heartbeat zamiast wielu zadań cron.
• Użyj target: "none" w heartbeat, jeśli chcesz tylko przetwarzania wewnętrznego.
• Dla rutynowych zadań używaj izolowanego cron z tańszym modelem.

​

Powiązane

• Heartbeat – pełna konfiguracja heartbeat
• Cron jobs – pełne referencje CLI i API dla cron
• System – zdarzenia systemowe + kontrola heartbeat