Skip to main content

​
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:
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