Logging (macOS)

Rotierendes Diagnose-Dateilog (Debug-Bereich)

OpenClaw leitet macOS-App-Logs über swift-log (standardmäßig Unified Logging) und kann bei Bedarf ein lokales, rotierendes Dateilog auf die Festplatte schreiben, wenn du eine dauerhafte Aufzeichnung brauchst.

  • Ausführlichkeit: Debug-Bereich → Logs → App logging → Verbosity
  • Aktivieren: Debug-Bereich → Logs → App logging → “Write rolling diagnostics log (JSONL)”
  • Speicherort: ~/Library/Logs/OpenClaw/diagnostics.jsonl (rotiert automatisch; alte Dateien bekommen die Endungen .1, .2, …)
  • Löschen: Debug-Bereich → Logs → App logging → “Clear”

Hinweise:

  • Diese Funktion ist standardmäßig deaktiviert. Aktiviere sie nur während des aktiven Debuggens.
  • Behandle die Datei als sensibel; teile sie nicht ohne vorherige Prüfung.

Unified Logging Private Data auf macOS

Unified Logging schwärzt die meisten Payloads, es sei denn, ein Subsystem aktiviert explizit privacy -off. Laut Peters Artikel über macOS Logging Privacy Shenanigans (2025) wird dies über eine plist-Datei in /Library/Preferences/Logging/Subsystems/ gesteuert, die nach dem Subsystem-Namen benannt ist. Nur neue Log-Einträge übernehmen das Flag, also aktiviere es vor dem Reproduzieren eines Problems.

Aktivieren für OpenClaw (bot.molt)

  • Schreibe die plist zuerst in eine temporäre Datei und installiere sie dann atomar als root:
cat <<'EOF' >/tmp/bot.molt.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/bot.molt.plist /Library/Preferences/Logging/Subsystems/bot.molt.plist
  • Ein Neustart ist nicht erforderlich; logd bemerkt die Datei schnell, aber nur neue Log-Zeilen enthalten dann private Payloads.
  • Zeige die erweiterte Ausgabe mit dem vorhandenen Helper an, z. B. ./scripts/clawlog.sh --category WebChat --last 5m.

Deaktivieren nach dem Debuggen

  • Entferne die Override-Datei: sudo rm /Library/Preferences/Logging/Subsystems/bot.molt.plist.
  • Optional kannst du sudo log config --reload ausführen, um logd zu zwingen, die Override-Einstellung sofort zu verwerfen.
  • Denk daran, dass diese Logs Telefonnummern und Nachrichteninhalte enthalten können; behalte die plist nur so lange aktiv, wie du die zusätzlichen Details wirklich brauchst.