Skip to main content

​
Journalisation (macOS)

​
Fichier journal tournant de diagnostic (volet Débogage)

L’application macOS journalise via swift-log (journalisation unifiée par défaut) et peut également écrire dans un fichier journal local tournant pour une conservation durable (DiagnosticsFileLog).
  • Activer : Debug pane -> Logs -> App logging -> “Write rolling diagnostics log (JSONL)” (désactivé par défaut).
  • Niveau de détail : sélecteur Debug pane -> Logs -> App logging -> Verbosity.
  • Emplacement : ~/Library/Logs/OpenClaw/diagnostics.jsonl.
  • Rotation : rotation à 5 Mo ; jusqu’à 5 sauvegardes portant les suffixes .1….5 (la plus ancienne est supprimée).
  • Effacer : Debug pane -> Logs -> App logging -> “Clear” supprime le fichier actif et toutes les sauvegardes.
Considérez ce fichier comme sensible ; ne le partagez pas sans l’avoir examiné.

​
Données privées de la journalisation unifiée sous macOS

La journalisation unifiée masque la plupart des charges utiles, sauf si un sous-système active privacy -off. Ce comportement est contrôlé par un fichier plist dans /Library/Preferences/Logging/Subsystems/, indexé par le nom du sous-système. Seules les nouvelles entrées de journal tiennent compte de cette option ; activez-la donc avant de reproduire un problème. Contexte : péripéties liées à la confidentialité de la journalisation macOS.

​
Activation pour OpenClaw (ai.openclaw)

Écrivez d’abord le fichier plist dans un fichier temporaire, puis installez-le de manière atomique en tant que superutilisateur :
Aucun redémarrage n’est nécessaire ; logd prend rapidement en compte le fichier, mais seules les nouvelles lignes de journal incluent les charges utiles privées. Consultez la sortie plus détaillée avec ./scripts/clawlog.sh --category WebChat --last 5m (--last/-l définit l’intervalle de temps, 5m par défaut ; --category/-c filtre par catégorie).

​
Désactivation après le débogage

  • Supprimez le remplacement : sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist.
  • Vous pouvez éventuellement exécuter sudo log config --reload pour forcer logd à abandonner immédiatement le remplacement.
  • Cette fonctionnalité peut inclure des numéros de téléphone et le contenu des messages ; ne conservez le fichier plist en place que lorsqu’il est activement nécessaire.

​
Voir aussi