Logging unter macOS mit OpenClaw

Es gibt kaum etwas Nervigeres, als einen Bug zu jagen und festzustellen, dass die Logs genau an der entscheidenden Stelle abgeschnitten sind. Wenn wichtige Details fehlen, wird die Fehlersuche zum Ratespiel und kostet unnötig Zeit.

Oft blockieren Standard-Systemeinstellungen den Zugriff auf die Daten, die du für eine Lösung brauchst. Mit dem richtigen Setup kommst du direkt an die Informationen, die sonst im Hintergrund von macOS verborgen bleiben.

Voraussetzungen

• OpenClaw macOS App
• Terminal-Zugriff mit Administratorrechten
• Zugriff auf das Debug pane der App
• Das Skript ./scripts/clawlog.sh

Schnellstart

In weniger als fünf Minuten hast du volle Sichtbarkeit über deine App-Logs:

1. Rolling Diagnostics Log aktivieren Navigiere zu Debug pane → Logs → App logging und aktiviere “Write rolling diagnostics log (JSONL)”. Die Datei wird unter ~/Library/Logs/OpenClaw/diagnostics.jsonl gespeichert und rotiert automatisch (alte Dateien erhalten Endungen wie .1 oder .2).

2. Private Daten freischalten macOS maskiert sensible Payloads im Unified Logging. Um dies für bot.molt zu umgehen, erstelle eine Konfigurationsdatei und installiere sie 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

3. Logs im Terminal auslesen Verwende das Helper-Skript, um die detaillierten Ausgaben zu betrachten: ./scripts/clawlog.sh --category WebChat --last 5m

4. Bereinigung nach dem Debugging Entferne die plist-Datei, wenn du sie nicht mehr benötigst, da sie sensible Daten wie Telefonnummern enthalten kann: sudo rm /Library/Preferences/Logging/Subsystems/bot.molt.plist

Fehlerbehebung

• Daten werden weiterhin als <private> angezeigt: Nur neue Log-Einträge übernehmen die Änderung. Aktiviere die plist-Datei unbedingt, bevor du das Problem reproduzierst.
• Rolling Log Datei wird nicht erstellt: Diese Funktion ist standardmäßig deaktiviert. Stelle sicher, dass die Option im Debug pane unter App logging aktiv gesetzt ist.

AI Setup Assistant

Nächste Schritte

• macOS Unified Logging Deep Dive
• OpenClaw CLI Reference