Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Logging (macOS)

​
Log diagnostico su file a rotazione (pannello Debug)

OpenClaw instrada i log dell’app macOS tramite swift-log (logging unificato per impostazione predefinita) e può scrivere su disco un log locale su file, con rotazione, quando serve un’acquisizione persistente.
  • Verbosità: pannello Debug → Log → Logging dell’app → Verbosità
  • Abilita: pannello Debug → Log → Logging dell’app → “Scrivi log diagnostico a rotazione (JSONL)”
  • Posizione: ~/Library/Logs/OpenClaw/diagnostics.jsonl (ruota automaticamente; i file vecchi hanno suffissi .1, .2, …)
  • Cancella: pannello Debug → Log → Logging dell’app → “Cancella”
Note:
  • È disattivato per impostazione predefinita. Abilitalo solo durante il debug attivo.
  • Tratta il file come sensibile; non condividerlo senza revisione.

​
Dati privati del logging unificato su macOS

Il logging unificato redige la maggior parte dei payload a meno che un sottosistema non attivi privacy -off. Secondo l’articolo di Peter sulle bizzarrie della privacy del logging su macOS (2025), questa impostazione è controllata da un plist in /Library/Preferences/Logging/Subsystems/ indicizzato per nome del sottosistema. Solo le nuove voci di log recepiscono il flag, quindi abilitalo prima di riprodurre un problema.

​
Abilitare per OpenClaw (ai.openclaw)

  • Scrivi prima il plist in un file temporaneo, poi installalo atomicamente come root:
cat <<'EOF' >/tmp/ai.openclaw.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/ai.openclaw.plist /Library/Preferences/Logging/Subsystems/ai.openclaw.plist
  • Non è richiesto alcun riavvio; logd rileva rapidamente il file, ma solo le nuove righe di log includeranno i payload privati.
  • Visualizza l’output più ricco con l’helper esistente, ad esempio ./scripts/clawlog.sh --category WebChat --last 5m.

​
Disabilitare dopo il debug

  • Rimuovi l’override: sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist.
  • Facoltativamente esegui sudo log config --reload per forzare logd a scartare subito l’override.
  • Ricorda che questa superficie può includere numeri di telefono e corpi dei messaggi; lascia il plist in posizione solo mentre hai attivamente bisogno del dettaglio aggiuntivo.

​
Correlati