Hoppa till huvudinnehåll

​
Loggning (macOS)

​
Rullande diagnostikfillogg (Debug-pane)

OpenClaw dirigerar macOS-apploggar via swift-log (unified logging som standard) och kan skriva en lokal, roterande fillogg till disk när du behöver en varaktig logginsamling.
  • Verbositet: Debug-pane → Logs → App logging → Verbosity
  • Aktivera: Debug-pane → Logs → App logging → ”Write rolling diagnostics log (JSONL)”
  • Plats: ~/Library/Logs/OpenClaw/diagnostics.jsonl (roterar automatiskt; gamla filer får suffixen .1, .2, …)
  • Rensa: Debug-pane → Logs → App logging → ”Clear”
Noteringar:
  • Detta är av som standard. Aktivera endast vid aktiv felsökning.
  • Behandla filen som känslig; dela den inte utan granskning.

​
Unified logging: privata data på macOS

Enhetlig loggning ändrar de flesta payloads såvida inte ett delsystem väljer i privacy -off. Per Peter’s write-up on macOS logging privacy shenanigans (2025) this is controlled by a plist in /Library/Preferences/Logging/Subsystems/ keyed by the subsystem name. Endast nya loggposter plocka upp flaggan, så aktivera det innan du reproducerar ett problem.

​
Aktivera för OpenClaw (bot.molt)

  • Skriv plist-filen till en temporär fil först och installera den sedan atomiskt som 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
  • Ingen omstart krävs; logd upptäcker filen snabbt, men endast nya loggrader kommer att inkludera privata nyttolaster.
  • Visa den rikare utmatningen med den befintliga hjälparen, t.ex. ./scripts/clawlog.sh --category WebChat --last 5m.

​
Inaktivera efter felsökning

  • Ta bort åsidosättningen: sudo rm /Library/Preferences/Logging/Subsystems/bot.molt.plist.
  • Kör eventuellt sudo log config --reload för att tvinga logd att omedelbart släppa åsidosättningen.
  • Kom ihåg att denna yta kan innehålla telefonnummer och meddelandetexter; behåll plist-filen endast så länge du aktivt behöver den extra detaljnivån.