Logging en macOS

OpenClaw enruta los logs de la app macOS a través de swift-log (logging unificado por defecto) y puede escribir un log de archivo local rotativo a disco cuando necesitas una captura duradera.

- Verbosidad: Panel Debug → Logs → App logging → Verbosidad

- Habilitar: Panel Debug → Logs → App logging → "Write rolling diagnostics log (JSONL)"

- Ubicación: ''~/Library/Logs/OpenClaw/diagnostics.jsonl'' (rota automáticamente; archivos antiguos se sufijan con ''.1'', ''.2'', …)

- Limpiar: Panel Debug → Logs → App logging → "Clear"

Notas:

- Esto está desactivado por defecto. Habilita solo mientras depuras activamente.

- Trata el archivo como sensible; no lo compartas sin revisión.

El logging unificado redacta la mayoría de payloads a menos que un subsistema opte por ''privacy -off''. Según el artículo de Peter sobre ''shenanigans de privacidad de logging'' en macOS (2025), esto se controla mediante un plist en ''/Library/Preferences/Logging/Subsystems/'' con clave por nombre de subsistema. Solo las nuevas entradas de log toman el flag, así que habilítalo antes de reproducir un problema.

- Escribe el plist a un archivo temporal primero, luego instálalo atómicamente como root:

cat '<<''EOF'' >'/tmp/bot.molt.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>'
EOF
sudo install -m 644 -o root -g wheel /tmp/bot.molt.plist /Library/Preferences/Logging/Subsystems/bot.molt.plist

- No se requiere reinicio; logd nota el archivo rápidamente, pero solo las nuevas líneas de log incluirán payloads privados.

- Ver salida más rica con el helper existente, ej. ''./scripts/clawlog.sh --category WebChat --last 5m''.

- Elimina la sobrescritura: ''sudo rm /Library/Preferences/Logging/Subsystems/bot.molt.plist''.

- Opcionalmente ejecuta ''sudo log config --reload'' para forzar a logd a soltar la sobrescritura inmediatamente.

- Recuerda que esta superficie puede incluir números de teléfono y cuerpos de mensajes; mantén el plist en su lugar solo mientras necesitas activamente el detalle extra.