Logregistratie (macOS)¶

Roterend diagnostisch bestandslog (Debug-paneel)¶

OpenClaw leidt macOS-app-logs via swift-log (standaard unified logging) en kan een lokaal, roterend bestandslog naar schijf schrijven wanneer je een duurzame vastlegging nodig hebt.

• Uitgebreidheid: Debug-paneel → Logs → App-logging → Uitgebreidheid
• Inschakelen: Debug-paneel → Logs → App-logging → “Roterend diagnostisch log schrijven (JSONL)”
• Locatie: ~/Library/Logs/OpenClaw/diagnostics.jsonl (roteert automatisch; oude bestanden krijgen het achtervoegsel .1, .2, …)
• Wissen: Debug-paneel → Logs → App-logging → “Wissen”

Notities:

• Dit staat standaard uit. Schakel het alleen in tijdens actief debuggen.
• Behandel het bestand als gevoelig; deel het niet zonder controle.

Private gegevens in unified logging op macOS¶

Unified logging redigeert de meeste payloads, tenzij een subsysteem zich aanmeldt voor privacy -off. Volgens Peter’s uiteenzetting over macOS logging privacy shenanigans (2025) wordt dit geregeld via een plist in /Library/Preferences/Logging/Subsystems/ die is gesleuteld op de naam van het subsysteem. Alleen nieuwe logregels nemen de vlag over, dus schakel dit in vóórdat je een probleem reproduceert.

Inschakelen voor OpenClaw (bot.molt)¶

• Schrijf de plist eerst naar een tijdelijk bestand en installeer deze daarna atomair 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

• Er is geen herstart nodig; logd merkt het bestand snel op, maar alleen nieuwe logregels bevatten private payloads.
• Bekijk de rijkere uitvoer met de bestaande helper, bijvoorbeeld ./scripts/clawlog.sh --category WebChat --last 5m.

Uitschakelen na het debuggen¶

• Verwijder de override: sudo rm /Library/Preferences/Logging/Subsystems/bot.molt.plist.
• Voer optioneel sudo log config --reload uit om logd te dwingen de override onmiddellijk te laten vallen.
• Onthoud dat dit oppervlak telefoonnummers en berichtinhoud kan bevatten; laat de plist alleen staan zolang je de extra details actief nodig hebt.