Passer au contenu principal

​
Journalisation (macOS)

​
Journal de diagnostic rotatif (volet Debug)

OpenClaw achemine les journaux de l’application macOS via swift-log (journalisation unifiée par défaut) et peut écrire un journal local rotatif sur disque lorsque vous avez besoin d’une capture durable.
  • Verbosité : Volet Debug → Logs → App logging → Verbosity
  • Activer : Volet Debug → Logs → App logging → “Write rolling diagnostics log (JSONL)”
  • Emplacement : ~/Library/Logs/OpenClaw/diagnostics.jsonl (rotation automatique ; les anciens fichiers sont suffixés avec .1, .2, …)
  • Effacer : Volet Debug → Logs → App logging → “Clear”
Remarques :
  • Ceci est désactivé par défaut. Activez-le uniquement pendant un débogage actif.
  • Traitez ce fichier comme sensible ; ne le partagez pas sans l’avoir vérifié.

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

La journalisation unifiée masque la plupart des charges utiles sauf si un sous-système active privacy -off. Selon l’article de Peter sur les bizarreries de confidentialité de la journalisation sur macOS (2025), cela est contrôlé par un plist dans /Library/Preferences/Logging/Subsystems/ indexé par le nom du sous-système. Seules les nouvelles entrées de journal prennent ce drapeau en compte, donc activez-le avant de reproduire un problème.

​
Activer pour OpenClaw (ai.openclaw)

  • Écrivez d’abord le plist dans un fichier temporaire, puis installez-le atomiquement en root :
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>
EOF
sudo 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 remarque rapidement le fichier, mais seules les nouvelles lignes de journal incluront les charges utiles privées.
  • Affichez la sortie enrichie avec l’assistant existant, par exemple ./scripts/clawlog.sh --category WebChat --last 5m.

​
Désactiver après le débogage

  • Supprimez le remplacement : sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist.
  • Exécutez éventuellement sudo log config --reload pour forcer logd à abandonner immédiatement ce remplacement.
  • N’oubliez pas que cette surface peut inclure des numéros de téléphone et des corps de message ; ne laissez le plist en place que tant que vous avez activement besoin du niveau de détail supplémentaire.