Public : équipes qui automatisent les exports design avec OpenClaw sur un Mac distant — surveillance active, launchd vert, mais pas d’enqueue. Objectif : checklist reliant fusions et rechargement à chaud de la passerelle aux daemons, rotation des logs (faux « zéro événement »), permissions et sandbox. Mots-clés : OpenClaw, Mac distant, launchd, rotation des logs, surveillance de dossier. Plan : architecture, journaux système, seuils, FAQ, étapes.
Sommaire
Pourquoi fusion, journaux et écoute cassent ensemble
Trois schémas typiques lors d’une fusion « mineure » pendant des écritures continues :
- Cerveau partagé : passerelle OpenClaw à jour, plist launchd avec ancien
PATHouTOKEN_FILE— shell OK, invocations refusées. - Troncature : rotation des logs sur
StandardOutPathefface les preuves de déclenchement ; on croit à l’absence d’événements. - Retry aveugles : sans classification, boucles sur TCC/sandbox au lieu de corriger ACL ou montage.
| Symptôme | Premier contrôle | Piste de correction |
|---|---|---|
| Jobs stoppés après déploiement passerelle | sudo launchctl print gui/$(id -u)/<Label> : bloc d’environnement vs manifeste fusionné |
Recharger le plist après fusion ; vider la file avant rechargement à chaud |
| Trous dans le tail minute par minute | Taille du stdout vs seuil de rotation | Isoler errors.jsonl ; élargir le plafond ou décaler la compression |
| Écoute « verte », zéro enqueue | Règles d’ignore, extensions temporaires, idle debounce | Aligner le debounce sur le rythme d’export ; vérifier inode et chemins réels |
Architecture passerelle et tâches d’écoute
Deux plans sur le Mac distant : une passerelle longue durée qui applique en 2026 le rechargement à chaud après fusion (bundles Skills, routage modèle, règles sur localhost), et une tâche d’écoute qui traduit les événements FSEvents en file single-flight avec debounce. Les daemons launchd doivent survivre aux reloads sans mélanger deux révisions d’outils sur un même fichier partiellement écrit.
Règle opérationnelle : pas de reload passerelle pendant un rename atomique vers l’inbox sans mutex couvrant la fenêtre. Branchez l’écouteur sur la même URL loopback et le même fichier de jeton que la passerelle ; ordre documenté disque → reload passerelle → réarmement écoute. Pour files bornées et backoff, réutilisez le HowTo surveillance PNG, retry et archives de logs et le pipeline de relecture PNG par références.
Corrélation avec les journaux système
Le JSONL porte le métier (job_id, retry_class, skill_revision) ; le journal unifié macOS explique ce que l’app omet : redémarrages de service, SIGKILL, refus TCC. Par incident, capturez les deux : suivez le fichier JSONL sous la racine des jobs, puis lancez log show avec un prédicat serré (processus ou sous-système) sur la même fenêtre UTC.
Si les horodatages divergent, corrigez la dérive NTP avant de recouper les lignes — sinon les coupures launchd sembleront aléatoires. Exigez un trace_id du premier événement fichier jusqu’aux accès passerelle après rechargement ; s’il disparaît dès la fusion, c’est la chaîne de logs structurés qui a régressé, pas l’outil d’export.
launchd et seuils de taille des journaux
launchd redirige StandardOutPath et StandardErrorPath vers des fichiers bruts ; la rotation des logs est une politique que vous imposez (newsyslog.conf, script type logrotate, ou LaunchAgent de compression). Sur hôtes d’export Apple Silicon, un compromis fréquent consiste à faire tourner lorsqu’un stdout dépasse 50 à 200 Mo ou à cadence quotidienne — selon la première condition — tout en isolant un petit flux erreurs pour le tail de garde.
Si la rotation coupe un fichier pendant une rafale, les observateurs perdent des lignes : décalez la compression lourde ou sortez le debug verbeux du chemin critique. Harmonisez les versions Node et CLI déclarées dans EnvironmentVariables du plist avec ce que vous avez vérifié en SSH grâce au guide d’installation OpenClaw multiplateforme.
FAQ : absence d’événements, permissions, sandbox
Aucun événement — premier regard ?
Vérifiez que le chemin surveillé est sur volume APFS local et non un simple placeholder cloud ; parcourez les motifs d’ignore pour fichiers temporaires ; comparez le debounce (souvent 30 à 60 s) à la cadence réelle des exports ; assurez-vous que l’utilisateur du job launchd est celui qui écrit via SMB ou SFTP.
Permission denied — le retry suffit-il ?
Non : corrigez ACL POSIX, montage réseau ou accès disque complet pour le binaire ; classez la faute, mettez le fichier en quarantine et faites intervenir un humain plutôt qu’une boucle infinie.
Sandbox vs shell hôte ?
Les Raccourcis et bundles sandboxés n’équivalent pas à un shell complet sur l’hôte ; évitez les lectures vers des chemins protégés sous Library et reproduisez la disposition moindre privilège de vos runbooks de vigie.
Étapes opérateur (fusion → vérification → retry)
- Snapshot : plist, config passerelle, fin de
errors.jsonldans le ticket. - Drain : drapeau maintenance, fin des jobs en cours.
- Fusion + reload passerelle : chemin 2026, santé localhost.
- launchd :
bootout/bootstrapdu Label, puislaunchctl printpour l’environnement. - Test : un PNG témoin, enqueue JSONL, puis écoute continue.
- Rotation : plafond respecté après rafale synthétique.
- Références : debounce export ~45 s ; retry transitoires 5 avec jitter ; JSONL compressé 7 jours minimum audit.
- Risque : Skills partiellement à jour → faux échecs et quarantaine.
- Télémétrie :
trace_idfichier → passerelle obligatoire à distance.
Un Mac distant dédié fige chemins, launchd et racines d’export pour cette checklist. Pages publiques : accueil, louer un nœud, tarifs, SSH/VNC, blog.