OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

macOS companion app

Registrazione su macOS

Registrazione (macOS)

File di registro diagnostico a rotazione (pannello Debug)

L'app macOS registra gli eventi tramite swift-log (per impostazione predefinita, usando la registrazione unificata) e può anche scrivere un file di registro locale a rotazione per conservarli in modo persistente (DiagnosticsFileLog).

  • Abilitazione: Pannello Debug -> Registri -> Registrazione dell'app -> "Scrivi registro diagnostico a rotazione (JSONL)" (disabilitato per impostazione predefinita).
  • Livello di dettaglio: selettore Pannello Debug -> Registri -> Registrazione dell'app -> Livello di dettaglio.
  • Posizione: ~/Library/Logs/OpenClaw/diagnostics.jsonl.
  • Rotazione: avviene a 5 MB; vengono conservati fino a 5 backup con suffisso .1....5 (il più vecchio viene eliminato).
  • Cancellazione: Pannello Debug -> Registri -> Registrazione dell'app -> "Cancella" elimina il file attivo e tutti i backup.

Considera il file come sensibile; non condividerlo senza averlo esaminato.

Dati privati nella registrazione unificata su macOS

La registrazione unificata oscura la maggior parte dei payload, a meno che un sottosistema non abiliti privacy -off. Questa impostazione è controllata da un plist in /Library/Preferences/Logging/Subsystems/, identificato dal nome del sottosistema. Solo le nuove voci di registro recepiscono l'impostazione, quindi abilitala prima di riprodurre un problema. Approfondimento: particolarità della privacy della registrazione in macOS.

Abilitazione per OpenClaw (ai.openclaw)

Scrivi prima il plist in un file temporaneo, quindi installalo atomicamente come root:

bash
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>EOFsudo install -m 644 -o root -g wheel /tmp/ai.openclaw.plist /Library/Preferences/Logging/Subsystems/ai.openclaw.plist

Non è necessario riavviare; logd rileva rapidamente il file, ma solo le nuove righe di registro includono i payload privati. Visualizza l'output più dettagliato con ./scripts/clawlog.sh --category WebChat --last 5m (--last/-l imposta l'intervallo di tempo, con valore predefinito 5m; --category/-c filtra per categoria).

Disabilitazione dopo il debug

  • Rimuovi la sostituzione: sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist.
  • Facoltativamente, esegui sudo log config --reload per forzare logd a rimuovere immediatamente la sostituzione.
  • Questo registro può includere numeri di telefono e contenuti dei messaggi; mantieni il plist installato solo mentre è effettivamente necessario.

Argomenti correlati

Was this useful?
On this page

On this page