Skip to main content

​
Registro (macOS)

​
Registro de archivo de diagnóstico rotativo (panel Debug)

La aplicación de macOS registra mediante swift-log (registro unificado de forma predeterminada) y también puede escribir un registro de archivo local rotativo para una captura persistente (DiagnosticsFileLog).
  • Activación: Debug pane -> Logs -> App logging -> “Write rolling diagnostics log (JSONL)” (desactivado de forma predeterminada).
  • Nivel de detalle: selector Debug pane -> Logs -> App logging -> Verbosity.
  • Ubicación: ~/Library/Logs/OpenClaw/diagnostics.jsonl.
  • Rotación: rota al alcanzar 5 MB; conserva hasta 5 copias de seguridad con los sufijos .1….5 (se descarta la más antigua).
  • Borrado: Debug pane -> Logs -> App logging -> “Clear” elimina el archivo activo y todas las copias de seguridad.
El archivo debe tratarse como información confidencial; no debe compartirse sin revisarlo.

​
Datos privados del registro unificado en macOS

El registro unificado oculta la mayoría de las cargas útiles, salvo que un subsistema habilite privacy -off. Esto se controla mediante un plist en /Library/Preferences/Logging/Subsystems/, cuya clave es el nombre del subsistema. La opción solo se aplica a las nuevas entradas del registro, por lo que debe habilitarse antes de reproducir un problema. Más información: peculiaridades de la privacidad del registro de macOS.

​
Habilitación para OpenClaw (ai.openclaw)

Primero se escribe el plist en un archivo temporal y, después, se instala de forma atómica como root:
No es necesario reiniciar; logd detecta el archivo rápidamente, pero solo las nuevas líneas del registro incluyen cargas útiles privadas. La salida más detallada puede consultarse con ./scripts/clawlog.sh --category WebChat --last 5m (--last/-l establece el intervalo de tiempo, cuyo valor predeterminado es 5m; --category/-c filtra por categoría).

​
Desactivación después de la depuración

  • Elimine la anulación: sudo rm /Library/Preferences/Logging/Subsystems/ai.openclaw.plist.
  • Opcionalmente, ejecute sudo log config --reload para forzar que logd descarte la anulación de inmediato.
  • Esta superficie puede incluir números de teléfono y cuerpos de mensajes; mantenga el plist instalado solo mientras sea necesario.

​
Contenido relacionado