Logging (macOS)

Rollierende Diagnose-Dateilog (Debug-Bereich)

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

• Ausführlichkeit: Debug-Bereich → Logs → App-Logging → Ausführlichkeit
• Aktivieren: Debug-Bereich → Logs → App-Logging → „Rollierende Diagnose-Log schreiben (JSONL)”
• Speicherort: ~/Library/Logs/OpenClaw/diagnostics.jsonl (rotiert automatisch; alte Dateien erhalten die Endung .1, .2, …)
• Löschen: Debug-Bereich → Logs → App-Logging → „Löschen”

Hinweise:

• Das ist standardmäßig deaktiviert. Aktiviere es 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 redigiert die meisten Payloads, sofern ein Subsystem nicht privacy -off aktiviert. Laut Peters Artikel zu macOS-Logging-Privacy-Eigenheiten (2025) wird das über eine Plist 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.

Für OpenClaw aktivieren (ai.openclaw)

• Schreibe die Plist erst in eine temporäre Datei, dann installiere sie atomar als 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

• Kein Neustart erforderlich; logd bemerkt die Datei schnell, aber nur neue Log-Zeilen enthalten private Payloads.
• Sieh dir die detailliertere Ausgabe mit dem vorhandenen Helfer an, z. B. ./scripts/clawlog.sh --category WebChat --last 5m.

Nach dem Debuggen deaktivieren

• Entferne den Override: sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist.
• Optional führe sudo log config --reload aus, um logd zu zwingen, den Override sofort zu verwerfen.
• Beachte, dass diese Oberfläche Telefonnummern und Nachrichteninhalte enthalten kann; lass die Plist nur bestehen, während du die zusätzlichen Details aktiv brauchst.