​

Geplante Aufgaben (Cron)

​

Schnellstart

# Eine einmalige Erinnerung hinzufügen
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

# Ihre Jobs prüfen
openclaw cron list

# Ausführungsverlauf anzeigen
openclaw cron runs --id <job-id>

​

So funktioniert Cron

• Cron läuft innerhalb des Gateway-Prozesses (nicht innerhalb des Modells).
• Jobs werden unter ~/.openclaw/cron/jobs.json gespeichert, damit Neustarts keine Zeitpläne verlieren.
• Alle Cron-Ausführungen erstellen Einträge für Hintergrundaufgaben.
• Einmalige Jobs (--at) werden standardmäßig nach erfolgreicher Ausführung automatisch gelöscht.
• Isolierte Cron-Ausführungen schließen nach bestem Bemühen nachverfolgte Browser-Tabs/Prozesse für ihre cron:<jobId>-Sitzung, wenn die Ausführung abgeschlossen ist, damit abgekoppelte Browser-Automatisierung keine verwaisten Prozesse hinterlässt.
• Isolierte Cron-Ausführungen schützen außerdem vor veralteten Bestätigungsantworten. Wenn das erste Ergebnis nur ein vorläufiges Status-Update ist (on it, pulling everything together und ähnliche Hinweise) und keine untergeordnete Subagent-Ausführung mehr für die endgültige Antwort verantwortlich ist, fordert OpenClaw vor der Zustellung noch einmal das tatsächliche Ergebnis an.

​

Zeitplantypen

​

Ausführungsstile

​

Payload-Optionen für isolierte Jobs

• --message: Prompt-Text (für isolierte Jobs erforderlich)
• --model / --thinking: Überschreibungen für Modell und Thinking-Stufe
• --light-context: Einfügen der Workspace-Bootstrap-Datei überspringen
• --tools exec,read: einschränken, welche Tools der Job verwenden kann

1. Gmail-Hook-Modellüberschreibung (wenn die Ausführung von Gmail kam und diese Überschreibung zulässig ist)
2. model in der Payload pro Job
3. Gespeicherte Modellüberschreibung der Cron-Sitzung
4. Modellauswahl des Agenten/Standards

​

Zustellung und Ausgabe

• cron.failureDestination setzt einen globalen Standard für Fehlerbenachrichtigungen.
• job.delivery.failureDestination überschreibt dies pro Job.
• Wenn beides nicht gesetzt ist und der Job bereits über announce zustellt, fallen Fehlerbenachrichtigungen jetzt auf dieses primäre Ankündigungsziel zurück.
• delivery.failureDestination wird nur bei Jobs mit sessionTarget="isolated" unterstützt, sofern der primäre Zustellmodus nicht webhook ist.

​

CLI-Beispiele

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

​

Webhooks

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

​

Authentifizierung

• Authorization: Bearer <token> (empfohlen)
• 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 (erforderlich): Ereignisbeschreibung
• mode (optional): now (Standard) oder 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"}'

​

Zugeordnete Hooks (POST /hooks/<name>)

​

Sicherheit

• Halten Sie Hook-Endpunkte hinter loopback, tailnet oder einem vertrauenswürdigen Reverse-Proxy.
• Verwenden Sie ein dediziertes Hook-Token; verwenden Sie keine Gateway-Auth-Tokens erneut.
• Halten Sie hooks.path auf einem dedizierten Unterpfad; / wird abgelehnt.
• Setzen Sie hooks.allowedAgentIds, um explizites agentId-Routing zu begrenzen.
• Belassen Sie hooks.allowRequestSessionKey=false, sofern Sie keine vom Aufrufer ausgewählten Sitzungen benötigen.
• Wenn Sie hooks.allowRequestSessionKey aktivieren, setzen Sie auch hooks.allowedSessionKeyPrefixes, um zulässige Formen von Sitzungsschlüsseln einzuschränken.
• Hook-Payloads werden standardmäßig mit Sicherheitsgrenzen umhüllt.

​

Gmail-PubSub-Integration

​

Assistenten-Setup (empfohlen)

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

​

Automatischer Gateway-Start

​

Manuelles einmaliges Setup

1. Wählen Sie das GCP-Projekt aus, dem der von gog verwendete OAuth-Client gehört:

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

2. Thema erstellen und Gmail Push-Zugriff gewähren:

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. Die Watch starten:

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

​

Gmail-Modellüberschreibung

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

​

Jobs verwalten

# Alle Jobs auflisten
openclaw cron list

# Einen Job bearbeiten
openclaw cron edit <jobId> --message "Updated prompt" --model "opus"

# Einen Job jetzt erzwingen
openclaw cron run <jobId>

# Nur ausführen, wenn fällig
openclaw cron run <jobId> --due

# Ausführungsverlauf anzeigen
openclaw cron runs --id <jobId> --limit 50

# Einen Job löschen
openclaw cron remove <jobId>

# Agentenauswahl (Setups mit mehreren Agenten)
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 ... ändert das ausgewählte Modell des Jobs.
• Wenn das Modell zulässig ist, erreicht genau dieser Provider/dieses Modell die isolierte Agenten- Ausführung.
• Wenn es nicht zulässig ist, warnt Cron und greift auf die Modellauswahl des Agenten/Standards für den Job zurück.
• Konfigurierte Fallback-Ketten gelten weiterhin, aber eine einfache --model-Überschreibung mit keiner expliziten Fallback-Liste pro Job fällt nicht mehr auf das Primärmodell des Agenten als stilles zusätzliches Wiederholungsziel zurück.

​

Konfiguration

{
  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 },
  },
}

​

Fehlerbehebung

​

Befehlsleiter

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 wird nicht ausgelöst

• Prüfen Sie cron.enabled und die Umgebungsvariable OPENCLAW_SKIP_CRON.
• Bestätigen Sie, dass das Gateway dauerhaft läuft.
• Prüfen Sie bei Zeitplänen vom Typ cron die Zeitzone (--tz) im Vergleich zur Zeitzone des Hosts.
• reason: not-due in der Ausführungsausgabe bedeutet, dass eine manuelle Ausführung mit openclaw cron run <jobId> --due geprüft wurde und der Job noch nicht fällig war.

​

Cron wurde ausgelöst, aber keine Zustellung

• Zustellmodus none bedeutet, dass keine externe Nachricht erwartet wird.
• Fehlendes/ungültiges Zustellziel (channel/to) bedeutet, dass ausgehende Zustellung übersprungen wurde.
• Kanal-Auth-Fehler (unauthorized, Forbidden) bedeuten, dass die Zustellung durch Anmeldedaten blockiert wurde.
• Wenn die isolierte Ausführung nur das stille Token (NO_REPLY / no_reply) zurückgibt, unterdrückt OpenClaw die direkte ausgehende Zustellung und auch den Fallback- Zusammenfassungspfad in der Warteschlange, sodass nichts zurück in den Chat gepostet wird.
• Erwarten Sie bei isolierten Jobs, die Cron gehören, nicht, dass der Agent das message-Tool als Fallback verwendet. Der Runner besitzt die endgültige Zustellung; --no-deliver hält sie intern, statt eine direkte Sendung zu erlauben.

​

Fallstricke bei Zeitzonen

• Cron ohne --tz verwendet die Zeitzone des Gateway-Hosts.
• Zeitpläne vom Typ at ohne Zeitzone werden als UTC behandelt.
• Heartbeat-activeHours verwendet die konfigurierte Zeitzonenauflösung.

​

Verwandt

• Automatisierung & Aufgaben — alle Automatisierungsmechanismen auf einen Blick
• Hintergrundaufgaben — Aufgabenprotokoll für Cron-Ausführungen
• Heartbeat — periodische Turns der Hauptsitzung
• Zeitzone — Zeitzonenkonfiguration