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

macOS companion app

Registro em log no macOS

Registro de logs (macOS)

Log de arquivo de diagnóstico rotativo (painel de Depuração)

O aplicativo para macOS registra logs por meio do swift-log (usando o sistema unificado de logs por padrão) e também pode gravar um log rotativo em um arquivo local para captura persistente (DiagnosticsFileLog).

  • Ativar: painel de Depuração -> Logs -> App logging -> "Write rolling diagnostics log (JSONL)" (desativado por padrão).
  • Nível de detalhamento: seletor painel de Depuração -> Logs -> App logging -> Verbosity.
  • Local: ~/Library/Logs/OpenClaw/diagnostics.jsonl.
  • Rotação: ocorre ao atingir 5 MB; mantém até 5 backups com os sufixos .1....5 (o mais antigo é descartado).
  • Limpar: painel de Depuração -> Logs -> App logging -> "Clear" exclui o arquivo ativo e todos os backups.

Trate o arquivo como confidencial; não o compartilhe sem revisá-lo.

Dados privados no sistema unificado de logs do macOS

O sistema unificado de logs oculta a maioria das cargas úteis, a menos que um subsistema habilite privacy -off. Isso é controlado por um plist em /Library/Preferences/Logging/Subsystems/, identificado pelo nome do subsistema. Somente novas entradas de log aplicam essa opção; portanto, ative-a antes de reproduzir um problema. Contexto: peculiaridades de privacidade do sistema de logs do macOS.

Ativar para o OpenClaw (ai.openclaw)

Primeiro, grave o plist em um arquivo temporário e depois instale-o atomicamente como 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

Não é necessário reiniciar; o logd detecta o arquivo rapidamente, mas somente novas linhas de log incluem cargas úteis privadas. Veja a saída mais detalhada com ./scripts/clawlog.sh --category WebChat --last 5m (--last/-l define o intervalo de tempo, com o padrão 5m; --category/-c filtra por categoria).

Desativar após a depuração

  • Remova a substituição: sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist.
  • Opcionalmente, execute sudo log config --reload para forçar o logd a descartar a substituição imediatamente.
  • Essa saída pode incluir números de telefone e o conteúdo das mensagens; mantenha o plist instalado somente enquanto ele for realmente necessário.

Relacionado

Was this useful?
On this page

On this page