Skip to main content

​
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:
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