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 de macOS

Registro (macOS)

Registro de archivo de diagnóstico rotativo (panel de depuración)

La aplicación para macOS registra mediante swift-log (con el registro unificado de forma predeterminada) y también puede escribir un archivo de registro local rotativo para conservar los datos capturados (DiagnosticsFileLog).

  • Activar: Panel de depuración -> Registros -> Registro de la aplicación -> "Escribir registro de diagnóstico rotativo (JSONL)" (desactivado de forma predeterminada).
  • Nivel de detalle: selector Panel de depuración -> Registros -> Registro de la aplicación -> Nivel de detalle.
  • 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 elimina la más antigua).
  • Borrar: Panel de depuración -> Registros -> Registro de la aplicación -> "Borrar" elimina el archivo activo y todas las copias de seguridad.

Trate el archivo como información confidencial; no lo comparta 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/, identificado por el nombre del subsistema. Solo las nuevas entradas de registro aplican la opción, por lo que debe activarla antes de reproducir un problema. Más información: peculiaridades de privacidad del registro de macOS.

Activar para OpenClaw (ai.openclaw)

Primero escriba el plist en un archivo temporal y, a continuación, instálelo atómicamente 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

No es necesario reiniciar; logd detecta el archivo rápidamente, pero solo las nuevas líneas de registro incluyen cargas útiles privadas. Consulte la salida más detallada con ./scripts/clawlog.sh --category WebChat --last 5m (--last/-l establece el intervalo de tiempo, con 5m como valor predeterminado; --category/-c filtra por categoría).

Desactivar 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 información puede incluir números de teléfono y cuerpos de mensajes; mantenga el plist instalado únicamente mientras sea necesario.

Contenido relacionado

Was this useful?
On this page

On this page