Protokollierung (macOS)

Rotierende Diagnoseprotokolldatei (Debug-Bereich)

Die macOS-App protokolliert über swift-log (standardmäßig einheitliche Protokollierung) und kann für eine dauerhafte Erfassung zusätzlich ein rotierendes lokales Dateiprotokoll schreiben (DiagnosticsFileLog).

• Aktivieren: Debug-Bereich -> Protokolle -> App-Protokollierung -> „Rotierendes Diagnoseprotokoll schreiben (JSONL)“ (standardmäßig deaktiviert).
• Ausführlichkeit: Auswahlfeld Debug-Bereich -> Protokolle -> App-Protokollierung -> Ausführlichkeit.
• Speicherort: ~/Library/Logs/OpenClaw/diagnostics.jsonl.
• Rotation: Die Datei wird bei 5 MB rotiert; bis zu 5 Sicherungen mit den Endungen .1....5 werden aufbewahrt (die älteste wird gelöscht).
• Löschen: Debug-Bereich -> Protokolle -> App-Protokollierung -> „Löschen“ löscht die aktive Datei und alle Sicherungen.

Behandeln Sie die Datei als vertraulich und geben Sie sie nicht ohne vorherige Prüfung weiter.

Private Daten in der einheitlichen Protokollierung unter macOS

Die einheitliche Protokollierung schwärzt die meisten Nutzdaten, sofern ein Subsystem nicht privacy -off aktiviert. Dies wird durch eine plist-Datei in /Library/Preferences/Logging/Subsystems/ gesteuert, deren Schlüssel der Name des Subsystems ist. Das Flag gilt nur für neue Protokolleinträge; aktivieren Sie es daher, bevor Sie ein Problem reproduzieren. Hintergrundinformationen: Besonderheiten des Datenschutzes bei der macOS-Protokollierung.

Für OpenClaw aktivieren (ai.openclaw)

Schreiben Sie die plist-Datei zunächst in eine temporäre Datei und installieren Sie sie anschließend 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>EOFsudo install -m 644 -o root -g wheel /tmp/ai.openclaw.plist /Library/Preferences/Logging/Subsystems/ai.openclaw.plist

Ein Neustart ist nicht erforderlich; logd übernimmt die Datei schnell, aber nur neue Protokollzeilen enthalten private Nutzdaten. Zeigen Sie die ausführlichere Ausgabe mit ./scripts/clawlog.sh --category WebChat --last 5m an (--last/-l legt den Zeitraum fest, standardmäßig 5m; --category/-c filtert nach Kategorie).

Nach der Fehlerdiagnose deaktivieren

• Entfernen Sie die Überschreibung: sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist.
• Führen Sie optional sudo log config --reload aus, damit logd die Überschreibung sofort verwirft.
• Diese Ausgabe kann Telefonnummern und Nachrichteninhalte enthalten; behalten Sie die plist-Datei nur so lange bei, wie sie aktiv benötigt wird.

Verwandte Themen

• macOS-App
• Gateway-Protokollierung