2026 : OpenClaw sur Mac Mini loué — fan-out cron générique, sondes santé fusionnées, webhooks avec backoff exponentiel et rôle de launchd

À qui s’adresse ce guide : équipes qui pilotent des workers shell sur Apple Silicon distant. Conclusion : un chemin minimal reproductible — gabarit crontab, flock, JSON unique pour l’état OpenClaw, alertes avec backoff exponentiel, et launchd comme alternative de minuteur. Structure : matrice de choix, HowTo en sept gestes, repères chiffrés et FAQ. Pour le cadencement 7×24, croisez avec la matrice files et planification ; pour les métriques système, le guide Node Exporter et seuils complète les sondes fichier décrites ici.

Freins typiques lorsque cron et OpenClaw cohabitent sur un hôte loué

1. Recouvrement des ticks. Un pas de cinq minutes qui lance douze workers sans flock duplique effets de bord et verrous base de données difficiles à corréler.
2. Prolifération des sondes. Cinq curl indépendants multiplient les webhooks avant même la politique OpenClaw, d’où fatigue d’alerte et perte de confiance dans l’astreinte.
3. Backoff absent. Sans fenêtre de silence persistée, le fournisseur limite le débit sur le même incident qui aurait dû produire une seule page groupée.

Matrice décisionnelle : lisibilité du fan-out, reprise après reboot, risque de double tir

Les notations supposent un Mac Mini en location où vous contrôlez des LaunchAgents utilisateur ou un sudo explicitement autorisé ; validez toujours la charte opérateur avant toute modification de démons système.

HowTo : sept gestes minimaux pour une recette reproductible

1. Gabarit crontab. Programmez un tick régulier, par exemple */5 * * * *, qui appelle un dispatcheur sous /usr/local/bin/runmini-dispatch.sh, vide la file rapidement et journalise en horodatage RFC3339 vers un répertoire locataire.
2. Verrou par sous-tâche. Encadrez chaque worker avec flock -n /var/run/task-foo.lock sh -c './worker.sh' afin qu’un tick lent bloque le suivant au lieu de le cloner.
3. Fusion des sondes. Un script contrôle la marge disque, la fraîcheur du battement des workers et une sortie HTTPS vers votre plan de contrôle ; il émet un JSON avec un champ overall valant healthy, degraded ou failed.
4. État agrégé OpenClaw. Pointez l’automation vers ce fichier ou exposez http://127.0.0.1:3001/health qui renvoie la même structure pour une ligne par hôte dans le tableau de bord.
5. Webhook sur transition. Lorsque overall quitte healthy, envoyez un POST JSON avec locataire, hôte, gravité et empreinte de la dernière ligne d’erreur standard.
6. Backoff exponentiel. Persistez last_alert_epoch et quiet_seconds ; doublez la fenêtre jusqu’à trente-deux minutes pendant l’échec persistant, puis réinitialisez à une minute au retour au vert.
7. Référence produit. Versionnez l’export crontab et le plist à côté de l’étiquette matériel ; pour le contexte OpenClaw, ouvrez la section publique sur l’index du blog avant de poser les secrets.

Articulation avec launchd : minuteur natif sans remplacer OpenClaw

launchd ne remplace pas la logique OpenClaw ; il remplace le déclencheur temporel. Préférez un LaunchAgent lorsque RunAtLoad doit relancer après reboot ou lorsque ThrottleInterval doit plafonner les rafales. Conservez les mêmes chemins de dispatcheur et de verrous pour garder des scripts portables entre environnements. Si l’hébergeur impose un élément de connexion géré, alignez-vous plutôt que d’éditer un cron racine opaque aux audits.

Lorsque vous dupliquez un planning, désactivez immédiatement les lignes cron redondantes : les déclencheurs mixtes cassent vite l’idempotence et brouillent les fichiers d’état du backoff.

FAQ

OpenClaw exige-t-il Prometheus dans cette pile minimale ?

Non : sondes shell et JSON suffisent souvent. Ajoutez Prometheus lorsque les contrôles fichier ne couvrent plus la finesse requise, comme dans le guide Node Exporter lié plus haut.

Où stocker l’état du backoff ?

Dans un petit fichier sous le répertoire locataire ou un chemin style var run avec permissions restrictives ; n’y placez ni secrets ni jetons, seulement horodatages et secondes de silence.

Et si flock est indisponible ?

Utilisez des verrous par répertoire créé atomiquement ou des verrous consultatifs SQLite ; l’invariant est un seul rédacteur par classe de sous-tâche, pas l’appel système précis.

Repères citables pour cadrer l’astreinte

• Cinq minutes comme pas par défaut du dispatcheur sur files interactives sûres pour un Mini loué.
• Trente-deux minutes comme plafond courant de la fenêtre de silence avant une nouvelle page sur incident prolongé.
• Une minute comme plancher de backoff après une transition propre vers healthy.