OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

macOS companion app

Journalisation macOS

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 :

bash
cat <<'EOF' >/tmp/ai.openclaw.plist<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"><dict>    <key>DEFAULT-OPTIONS</key>    <dict>        <key>Enable-Private-Data</key>        <true/>    </dict></dict></plist>EOFsudo install -m 644 -o root -g wheel /tmp/ai.openclaw.plist /Library/Preferences/Logging/Subsystems/ai.openclaw.plist

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

Was this useful?
On this page

On this page