> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS-loggning

# 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](https://steipete.me/posts/2025/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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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.