2026-05-21 cron OpenClaw intégré : sessions isolées, livraison webhook par tâche et décalage au redémarrage sur un Mac cloud Apple Silicon loué sans écran (HK / JP / KR / SG / US)
Les équipes qui louent un Mac mini M4 à Hong Kong, Tokyo, Séoul, Singapour ou aux États-Unis et exécutent OpenClaw en SSH sans écran passent souvent du chat réactif à l’automatisation planifiée : digests nocturnes, synthèses stand-up, scans d’expiration de certificats et tri des échecs CI vers Slack ou un webhook interne. Le cron intégré tourne dans le processus passerelle, persiste dans ~/.openclaw/cron/jobs.json et peut réveiller des agents en sessions isolées ou sur le heartbeat de la session principale. Ce guide 2026-05-21 fixe la politique : cron isolé pour le travail d’arrière-plan lourd en outils, cron principal pour les rappels légers, décaler les plannings d’au moins 2–5 minutes, webhook POST par tâche uniquement en TLS avec secrets partagés — jamais de HTTP clair sur une location partagée. Matrice de sessions, tableau planning + webhook, notes de décalage au redémarrage, huit étapes et triage, avec liens vers onboard + doctor, baseline launchd cron et politique outils MCP.
Qui a besoin du cron passerelle sur un Mac loué sans écran
launchd macOS peut lancer des scripts, mais pas raisonner sur le contexte agent, le routage modèle ou la livraison canal. Le cron OpenClaw comble ce vide : les plannings vivent avec la passerelle, survivent au redémarrage si jobs.json est intact, et routent la sortie vers les canaux ou HTTP. Sur un hôte loué, l’échec typique est opérationnel — cinq tâches à la même minute après déploiement, rattrapage groupé au retour de la passerelle, webhook pointant vers la préprod qui modifie les tickets production.
- SRE plateforme : digests JSON vers un collecteur interne sans second VM planificateur.
- Engineering managers : synthèses ripgrep + tickets sur un nœud Tokyo ou Singapour proche des dépôts APAC.
- Sécurité : sessions isolées pour qu’un prompt cron n’hérite pas des approbations outils de la session principale humaine.
Partez de la page d’accueil MacXCode : placez la passerelle où la RTT webhook vers votre VPC est minimale, documentez quelles tâches peuvent appeler des outils d’écriture.
Sessions isolée, principale et cibles cron nommées
Le cron peut cibler plusieurs contextes. Isolée : tour dédié — idéal pour rapports avec fichiers, MCP ou wrappers shell. Principale : prochain heartbeat — rappels légers. Session nommée persistante : journaux ops multi-semaines. Mauvais choix = pas de sortie (bugs de dispatch isolé) ou fil de chat humain pollué.
| Cible | Idéal pour | À éviter si | Note location |
|---|---|---|---|
| Session isolée | Digests nocturnes, scans MCP | Réponse instantanée dans le même fil | Max 2 isolées concurrentes sur un M4 |
| Principale + heartbeat | Rappels, calendrier | xcodebuild ou gros ripgrep |
Prompt < 2k tokens |
| Session persistante nommée | Journaux ops multi-semaines | Conformité exige contexte éphémère | Snapshot hebdo OPENCLAW_STATE_DIR |
--cron de 2–5 minutes ; les rafales simultanées déclenchent des 429 — voir backpressure API.
Types de planning, webhooks et matrice de livraison
Trois formes : --at (ponctuel ISO ou relatif 20m), --every, --cron (5/6 champs + fuseau IANA). Les ponctuels s’auto-suppriment souvent — vérifiez l’audit. Livraison webhook par tâche (2026.2.x+) POST les résumés en HTTPS — mêmes TLS/HMAC que les webhooks OpenClaw entrants.
| Planning | Exemple | Livraison | Checklist sans écran |
|---|---|---|---|
--cron + TZ |
0 9 * * 1-5 Asia/Tokyo |
Slack + webhook | TZ système vs --tz |
--every |
4h santé |
Webhook seul | Handler idempotent, runId |
--at |
Fumée 45m post-déploiement |
Session isolée | Code sortie dans logs launchd |
Redémarrage passerelle, retards et hygiène jobs.json
Le cron tourne dans la passerelle — chaque launchctl kickstart -k redémarre aussi le planificateur. Les tâches isolées en retard peuvent s’enfiler ensemble ; les builds récents décalent les exécutions manquées, mais traitez les fenêtres de redémarrage comme sensibles. Copiez jobs.json avant mise à niveau (checkpoint session). Une rafale d’ID cron à la même seconde précède souvent des 429.
Après bump npm : openclaw doctor. Si isolé en file sans sortie : basculez temporairement vers rappels principaux, désactivez outils d’écriture — pas de planning silencieux en production louée.
EnvironmentVariables du plist.
Huit étapes pour le cron OpenClaw sur Apple Silicon loué
- Santé passerelle :
openclaw doctoretlaunchctl print gui/$(id -u)/com.openclaw.gateway. - Sauvegarde
jobs.jsonetOPENCLAW_STATE_DIRavant le premier changement. - Une tâche digest isolée en lecture seule,
--crondécalé (ex. minute7). - Webhook HTTPS + en-tête HMAC ; valider 2xx en préprod.
- Fumée
--at 15m; confirmer auto-suppression vs audit. - Redémarrage passerelle en maintenance ; vérifier décalage des retards dans les logs.
- Documenter arrêt : désactiver entrées, kickstart, webhooks arrêtés.
- Après sept jours : télémétrie tokens ; ajuster modèle ou second hôte loué.
Exemple décalé (matinées Tokyo, isolé) :
openclaw cron add --cron "12 9 * * 1-5" --tz Asia/Tokyo --session isolated --message "Résumer échecs CI nocturnes ; outils lecture seule." --webhook https://hooks.internal.example/ci-digest
Triage quand le cron déraille sur une location sans écran
| Symptôme | Cause probable | Action |
|---|---|---|
| Jamais déclenché | Passerelle arrêtée ou TZ | launchd ; --tz vs date |
| Rafale au démarrage | Arriéré | Décaler ; mettre à niveau ; logs stagger |
| Webhook 401/403 | Secret pas dans plist | Variables env ; kickstart |
| Isolé en file, pas de sortie | Régression dispatch | Session principale temporaire ; doctor |
FAQ
Où sont stockées les tâches cron ? ~/.openclaw/cron/jobs.json — sauvegarde avant mise à niveau.
Isolée ou principale pour rapports nocturnes ? Isolée si outils lourds ; principale + heartbeat pour nudges légers.
Pourquoi inondation après redémarrage ? Rattrapage groupé — décalez et vérifiez le stagger au démarrage.
Avant webhooks production : index blog et aide pour l’accès SSH.
Pourquoi louer un Mac mini M4 pour cron + webhooks OpenClaw
Le M4 tient passerelle + deux cron isolés dans une enveloppe mémoire prévisible — contrairement aux VM x86 qui swappent sous ripgrep. Hong Kong ou Tokyo réduisent la RTT webhook APAC ; les nœuds US conviennent aux plannings américains. Automatisation 24/7 sans second Mac de bureau ; shard possible sur second loué selon télémétrie. Comparez sur les tarifs, répétez l’install passerelle dans l’aide, VNC seulement pour outils GUI.
Louez un hôte passerelle 24/7 pour un cron OpenClaw décalé
HK / JP / KR / SG / US · SSH · Mac mini M4 · webhooks