​

Zaplanowane zadania (Cron)

​

Szybki start

# Add a one-shot reminder
openclaw cron add \
  --name "Reminder" \
  --at "2026-02-01T16:00:00Z" \
  --session main \
  --system-event "Reminder: check the cron docs draft" \
  --wake now \
  --delete-after-run

# Check your jobs
openclaw cron list

# See run history
openclaw cron runs --id <job-id>

​

Jak działa cron

• Cron działa wewnątrz procesu Gateway (nie wewnątrz modelu).
• Zadania są zapisywane w ~/.openclaw/cron/jobs.json, więc ponowne uruchomienia nie powodują utraty harmonogramów.
• Wszystkie wykonania cron tworzą rekordy zadań w tle.
• Zadania jednorazowe (--at) są domyślnie automatycznie usuwane po pomyślnym wykonaniu.
• Izolowane uruchomienia cron przy zakończeniu wykonania próbują zamknąć śledzone karty/procesy przeglądarki dla sesji cron:<jobId>, aby odłączona automatyzacja przeglądarki nie pozostawiała osieroconych procesów.
• Izolowane uruchomienia cron chronią też przed nieaktualnymi odpowiedziami potwierdzającymi. Jeśli pierwszy wynik jest tylko tymczasową aktualizacją stanu (on it, pulling everything together i podobne wskazówki) i żadne podrzędne uruchomienie subagenta nie odpowiada już za końcową odpowiedź, OpenClaw ponawia prompt raz, aby uzyskać właściwy wynik przed dostarczeniem.

​

Typy harmonogramów

​

Style wykonania

​

Opcje ładunku dla zadań izolowanych

• --message: tekst promptu (wymagany dla izolowanych)
• --model / --thinking: nadpisania modelu i poziomu myślenia
• --light-context: pomiń wstrzykiwanie pliku bootstrap obszaru roboczego
• --tools exec,read: ogranicz, których narzędzi zadanie może używać

1. Nadpisanie modelu hooka Gmail (gdy uruchomienie pochodzi z Gmaila i to nadpisanie jest dozwolone)
2. model w ładunku dla danego zadania
3. Zapisane nadpisanie modelu sesji cron
4. Wybór modelu agenta/domyślnego

​

Dostarczanie i dane wyjściowe

• cron.failureDestination ustawia globalną wartość domyślną dla powiadomień o niepowodzeniu.
• job.delivery.failureDestination nadpisuje ją dla konkretnego zadania.
• Jeśli żadne z nich nie jest ustawione, a zadanie już dostarcza przez announce, powiadomienia o niepowodzeniu teraz wracają domyślnie do tego głównego celu announce.
• delivery.failureDestination jest obsługiwane tylko dla zadań z sessionTarget="isolated", chyba że podstawowym trybem dostarczania jest webhook.

​

Przykłady CLI

openclaw cron add \
  --name "Calendar check" \
  --at "20m" \
  --session main \
  --system-event "Next heartbeat: check calendar." \
  --wake now

openclaw cron add \
  --name "Morning brief" \
  --cron "0 7 * * *" \
  --tz "America/Los_Angeles" \
  --session isolated \
  --message "Summarize overnight updates." \
  --announce \
  --channel slack \
  --to "channel:C1234567890"

openclaw cron add \
  --name "Deep analysis" \
  --cron "0 6 * * 1" \
  --tz "America/Los_Angeles" \
  --session isolated \
  --message "Weekly deep analysis of project progress." \
  --model "opus" \
  --thinking high \
  --announce

​

Webhooki

{
  hooks: {
    enabled: true,
    token: "shared-secret",
    path: "/hooks",
  },
}

​

Uwierzytelnianie

• Authorization: Bearer <token> (zalecane)
• x-openclaw-token: <token>

​

POST /hooks/wake

curl -X POST http://127.0.0.1:18789/hooks/wake \
  -H 'Authorization: Bearer SECRET' \
  -H 'Content-Type: application/json' \
  -d '{"text":"New email received","mode":"now"}'

• text (wymagane): opis zdarzenia
• mode (opcjonalne): now (domyślnie) lub next-heartbeat

​

POST /hooks/agent

curl -X POST http://127.0.0.1:18789/hooks/agent \
  -H 'Authorization: Bearer SECRET' \
  -H 'Content-Type: application/json' \
  -d '{"message":"Summarize inbox","name":"Email","model":"openai/gpt-5.4-mini"}'

​

Zmapowane hooki (POST /hooks/<name>)

​

Bezpieczeństwo

• Utrzymuj punkty końcowe hooków za loopbackiem, tailnetem lub zaufanym reverse proxy.
• Używaj dedykowanego tokenu hooka; nie używaj ponownie tokenów uwierzytelniania gateway.
• Utrzymuj hooks.path na dedykowanej podścieżce; / jest odrzucane.
• Ustaw hooks.allowedAgentIds, aby ograniczyć jawne trasowanie agentId.
• Utrzymuj hooks.allowRequestSessionKey=false, chyba że potrzebujesz sesji wybieranych przez wywołującego.
• Jeśli włączysz hooks.allowRequestSessionKey, ustaw też hooks.allowedSessionKeyPrefixes, aby ograniczyć dozwolone kształty kluczy sesji.
• Ładunki hooków są domyślnie opakowywane granicami bezpieczeństwa.

​

Integracja Gmail PubSub

​

Konfiguracja kreatorem (zalecane)

openclaw webhooks gmail setup --account openclaw@gmail.com

​

Automatyczne uruchamianie Gateway

​

Ręczna jednorazowa konfiguracja

1. Wybierz projekt GCP, który jest właścicielem klienta OAuth używanego przez gog:

gcloud auth login
gcloud config set project <project-id>
gcloud services enable gmail.googleapis.com pubsub.googleapis.com

2. Utwórz temat i przyznaj Gmailowi dostęp push:

gcloud pubsub topics create gog-gmail-watch
gcloud pubsub topics add-iam-policy-binding gog-gmail-watch \
  --member=serviceAccount:gmail-api-push@system.gserviceaccount.com \
  --role=roles/pubsub.publisher

3. Uruchom obserwację:

gog gmail watch start \
  --account openclaw@gmail.com \
  --label INBOX \
  --topic projects/<project-id>/topics/gog-gmail-watch

​

Nadpisanie modelu Gmail

{
  hooks: {
    gmail: {
      model: "openrouter/meta-llama/llama-3.3-70b-instruct:free",
      thinking: "off",
    },
  },
}

​

Zarządzanie zadaniami

# List all jobs
openclaw cron list

# Edit a job
openclaw cron edit <jobId> --message "Updated prompt" --model "opus"

# Force run a job now
openclaw cron run <jobId>

# Run only if due
openclaw cron run <jobId> --due

# View run history
openclaw cron runs --id <jobId> --limit 50

# Delete a job
openclaw cron remove <jobId>

# Agent selection (multi-agent setups)
openclaw cron add --name "Ops sweep" --cron "0 6 * * *" --session isolated --message "Check ops queue" --agent ops
openclaw cron edit <jobId> --clear-agent

• openclaw cron add|edit --model ... zmienia wybrany model zadania.
• Jeśli model jest dozwolony, dokładnie ten dostawca/model trafia do izolowanego uruchomienia agenta.
• Jeśli nie jest dozwolony, cron wyświetla ostrzeżenie i wraca do wyboru modelu agenta/domyślnego dla zadania.
• Skonfigurowane łańcuchy fallbacków nadal obowiązują, ale zwykłe nadpisanie --model bez jawnej listy fallbacków dla zadania nie przechodzi już do modelu podstawowego agenta jako cichego dodatkowego celu ponowienia.

​

Konfiguracja

{
  cron: {
    enabled: true,
    store: "~/.openclaw/cron/jobs.json",
    maxConcurrentRuns: 1,
    retry: {
      maxAttempts: 3,
      backoffMs: [60000, 120000, 300000],
      retryOn: ["rate_limit", "overloaded", "network", "server_error"],
    },
    webhookToken: "replace-with-dedicated-webhook-token",
    sessionRetention: "24h",
    runLog: { maxBytes: "2mb", keepLines: 2000 },
  },
}

​

Rozwiązywanie problemów

​

Sekwencja poleceń

openclaw status
openclaw gateway status
openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw system heartbeat last
openclaw logs --follow
openclaw doctor

​

Cron się nie uruchamia

• Sprawdź cron.enabled i zmienną środowiskową OPENCLAW_SKIP_CRON.
• Potwierdź, że Gateway działa nieprzerwanie.
• W przypadku harmonogramów cron zweryfikuj strefę czasową (--tz) względem strefy czasowej hosta.
• reason: not-due w danych wyjściowych uruchomienia oznacza, że ręczne uruchomienie zostało sprawdzone przez openclaw cron run <jobId> --due, a zadanie nie było jeszcze wymagalne.

​

Cron uruchomił się, ale nic nie dostarczono

• Tryb dostarczania none oznacza, że nie należy oczekiwać żadnej zewnętrznej wiadomości.
• Brakujący/nieprawidłowy cel dostarczania (channel/to) oznacza, że wysyłka została pominięta.
• Błędy uwierzytelniania kanału (unauthorized, Forbidden) oznaczają, że dostarczanie zostało zablokowane przez poświadczenia.
• Jeśli izolowane uruchomienie zwróci tylko cichy token (NO_REPLY / no_reply), OpenClaw pomija bezpośrednie dostarczanie wychodzące, a także pomija awaryjną ścieżkę podsumowania w kolejce, więc nic nie zostanie opublikowane z powrotem na czacie.
• W przypadku izolowanych zadań zarządzanych przez cron nie oczekuj, że agent użyje narzędzia wiadomości jako fallbacku. Wykonawca zarządza końcowym dostarczeniem; --no-deliver utrzymuje je jako wewnętrzne zamiast zezwalać na bezpośrednią wysyłkę.

​

Pułapki związane ze strefami czasowymi

• Cron bez --tz używa strefy czasowej hosta gateway.
• Harmonogramy at bez strefy czasowej są traktowane jako UTC.
• activeHours heartbeat używa skonfigurowanego rozstrzygania strefy czasowej.

​

Powiązane

• Automatyzacja i zadania — wszystkie mechanizmy automatyzacji w skrócie
• Zadania w tle — rejestr zadań dla wykonań cron
• Heartbeat — okresowe obroty sesji głównej
• Strefa czasowa — konfiguracja strefy czasowej