Protokollierung (macOS)

Rotierende Diagnose-Dateiprotokolle (Debug-Bereich)

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

• Aktivieren: Debug pane -> Logs -> App logging -> "Write rolling diagnostics log (JSONL)" (standardmäßig deaktiviert).
• Ausführlichkeit: Auswahlfeld Debug pane -> Logs -> App logging -> Verbosity.
• Speicherort: ~/Library/Logs/OpenClaw/diagnostics.jsonl.
• Rotation: rotiert bei 5 MB; bis zu 5 Sicherungen mit den Suffixen .1....5 (die älteste wird gelöscht).
• Löschen: Debug pane -> Logs -> App logging -> "Clear" löscht die aktive Datei und alle Sicherungen.

Behandeln Sie die Datei als vertraulich; 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 privacy -off nicht ausdrücklich aktiviert. Dies wird durch eine nach Subsystemnamen gegliederte plist-Datei unter /Library/Preferences/Logging/Subsystems/ gesteuert. Nur neue Protokolleinträge berücksichtigen die Einstellung; aktivieren Sie sie daher, bevor Sie ein Problem reproduzieren. Hintergrund: Eigenheiten 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 Fehlersuche 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 Oberfläche 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