2026 OpenClaw : JSONL, rotation, corrélation, sur un Mac mini ProxyMac loué

Les équipes OpenClaw sur une ProxyMac Mac mini en Hong Kong, Japon, Corée, Singapour, États-Unis expédient le produit plus vite que l’observabilité—puis gèrent le bruit dès qu’un replay webhook cale. Un bon log n’est pas du texte en plus : c’est du JSONL stable, quatorze jours retenu, fsync sub-500ms (APFS), IDs de corrélation entre la passerelle HTTP et le démon. Ici, pourquoi le JSONL bat le mode joli, trois cibles en tableau, rotation côté M4, reprise d’ID, six vérifications LaunchAgent, liens probes, GitOps, triage de déploiement afin d’en faire de la preuve, pas d’histoire de fouilles.

S’ancrer d’abord sur l’aide, cadrer le disque grâce aux tarifs pour ne pas geler le budget quand la trace s’allume.

Le logging, fonction produit, pas bouchon d’impro

En audit, il faut la file de cause à effet, pas une capture d’écran. JSONL, champs trace_id, actor, tool, latency_ms pour rejoindre le SIEM. Sur M4, surveillez l’écriture chaude : 80 Mo/h d’appends en continu peut priver la mémoire d’agent SQLite, la rotation est load, pas cosmétique.

• API finance : WORM, export hebdo, JSONL, même discipline.
• Conflit fournisseur de modèles : prouver quelle clé, quelle cible, pas l’onglet de leur seule console.
• Bascule multi-région (voir bascule fournisseur) : drapeau de région par requête dans chaque log.

JSONL, Console, SIEM distant

Cible	Idéal	Cardinalité	Exploitation
JSONL tournant (APFS)	trace outil, rejeu	medium, schéma tenu	faible, jq local
Predicates, log unifié	subsystems, pannes	élevé, DLP	moyen, Console
Syslog distant, shipper	soc, audit	élevé, réseau	élevé, TLS+clé

Seuils qui passent l’assurance

Rotation quotidienne, retenu quatorze (compressé) locale, puis poussez la semaine, si 90 jours, vers l’objet, zstd côté M4, CPU sous 15 %. Associez l’ancienneté des fichiers à les sondes synthétiques pour que le disque plein devienne une métrique rouge avant qu’launchd refuse d’écrire.

#!/bin/bash # garde taille avant d’enclencher MAX_GB=6 USED=$(du -sg ~/Library/Logs/OpenClaw | awk '{print $1}') if [ "$USED" -ge "$MAX_GB" ]; then echo "log_quota_exceeded" >&2; exit 3; fi

Même file de corrélation : passerelle, JSONL, agent

Suivre le guide webhooks : terminer le TLS côté localhost, propager X-Request-Id (ou UUID) dans le contexte de tâche, une décision, une ligne, le même grep sur nginx, passerelle et agent. Suffixe -r2 pour chaque rejeu, id racine inchangée, la facturation déteste l’imprécis.

LaunchAgent, six vérifications avant d’y croire en prod

1. WorkingDirectory : ~/.openclaw ou dossier d’état, jamais Bureau iCloud.
2. StandardOut/Err dans ~/Library/Logs/OpenClaw/, 644, suffisent.
3. ThrottleInterval ≥ 10, sinon boucle.
4. Variables, TZ=UTC, toutes les régions.
5. KeepAlive à vrai dès qu’on fait confiance aux codes de retour, sinon cela dissimule l’inondation.
6. ProcessType : Interactive ou Background, conforme aux suppositions TCC de l’article autorisations.

Relier sondes, GitOps et dépannage — pas du contenu en double

Si le taux d’erreur JSON s’envole, comparez d’abord la dernière promotion Git enregistrée dans la config GitOps : un mauvais niveau de log coûte peu à corriger. Si l’échec est aléatoire, passez par récupération de déploiement avec pour pièces jointes un tarball des trois derniers fichiers rotatifs seulement — jamais un disque entier. En cas d’entrelacement des logs sous charge, revenez aux garde-fous des agents en parallèle : chaque worker écrit un préfixe, puis on fusionne en amont.

FAQ

JSONL vers seul stdout ? En dev, oui ; en production, le couple stdout + fichier tournant, sinon la capture launchd cesse dès la déconnexion de session.

Verbose, impact sur moteur ? Mesurez, souvent INFO+ DEBUG échantillonné, pas 100%.

RGPD, effacement : tenez l’inventaire des champs, pour cibler la bonne plage de jours, sans effacer d’autres locataires.

Pourquoi y centraliser les journaux

Le Silicium M4 d’Apple combine l’APFS, l’intégration Keychain côté identifiants du log shipper et des IOPS suffisants pour héberger agents, journaux et cibles de sortie, sur une seule machine, dans HK / JP / KR / SG / US. La location évite les négociations CapEx quand la conformité double soudainement la rétention ; cadrer ce point avec les tarifs régionaux rassure l’équipe finance. Gardez des opérateurs en boucle via VNC pour valider, archivez le JSONL au même dépôt que l’infra et transformez l’observabilité d’une corvée en atout.