Aller au contenu

cron

Gérer les tâches cron pour le planificateur du Gateway.

Connexes :

Conseil : exécutez openclaw cron --help pour voir toutes les commandes disponibles.

Remarque : les tâches isolées cron add utilisent par défaut la livraison --announce. Utilisez --no-deliver pour conserver la sortie en interne. --deliver reste un alias déprécié pour --announce.

Remarque : les tâches ponctuelles (--at) sont supprimées après réussite par défaut. Utilisez --keep-after-run pour les conserver.

Note : pour les tâches CLI ponctuelles, les dates/heures --at sans décalage sont traitées comme UTC, sauf si vous passez également --tz <iana>, qui interprète cette heure locale d’horloge murale dans le fuseau horaire donné.

Remarque : les tâches récurrentes utilisent désormais une attente exponentielle avec nouvelles tentatives après des erreurs consécutives (30 s → 1 min → 5 min → 15 min → 60 min), puis reviennent à la planification normale après la prochaine exécution réussie.

Remarque : openclaw cron run retourne désormais dès que l’exécution manuelle est mise en file d’attente. Les réponses réussies incluent { ok: true, enqueued: true, runId } ; utilisez openclaw cron runs --id <job-id> pour suivre le résultat final.

Remarque : la rétention/le nettoyage sont contrôlés dans la configuration :

  • cron.sessionRetention (par défaut 24h) nettoie les sessions d’exécution isolées terminées.
  • cron.runLog.maxBytes + cron.runLog.keepLines nettoient ~/.openclaw/cron/runs/<jobId>.jsonl.

Remarque de mise à jour : si vous avez d’anciennes tâches cron antérieures au format actuel de livraison/stockage, exécutez openclaw doctor --fix. Doctor normalise désormais les champs cron hérités (jobId, schedule.cron, champs de livraison de niveau supérieur, y compris l’ancien threadId, alias de livraison payload provider) et migre les simples tâches de secours webhook notify: true vers une livraison webhook explicite lorsque cron.webhook est configuré.

Mettre à jour les paramètres de livraison sans modifier le message :

Fenêtre de terminal
openclaw cron edit <job-id> --announce --channel telegram --to "123456789"

Désactiver la livraison pour une tâche isolée :

Fenêtre de terminal
openclaw cron edit <job-id> --no-deliver

Activer le contexte d’amorçage léger pour une tâche isolée :

Fenêtre de terminal
openclaw cron edit <job-id> --light-context

Annoncer dans un channel spécifique :

Fenêtre de terminal
openclaw cron edit <job-id> --announce --channel slack --to "channel:C1234567890"

Créer une tâche isolée avec un contexte d’amorçage léger :

Fenêtre de terminal
openclaw cron add \
--name "Lightweight morning brief" \
--cron "0 7 * * *" \
--session isolated \
--message "Summarize overnight updates." \
--light-context \
--no-deliver

--light-context s’applique uniquement aux tâches de tour d’agent isolées. Pour les exécutions cron, le mode léger garde le contexte d’amorçage vide au lieu d’injecter l’ensemble complet d’amorçage de l’espace de travail.