Gestión de logs en macOS para OpenClaw

Rastrear errores en macOS puede ser un dolor de cabeza cuando los logs no muestran suficiente detalle. A menudo te encuentras con mensajes censurados que impiden entender qué está pasando realmente en el sistema durante la ejecución.

Es frustrante perder tiempo intentando replicar un problema sin tener un registro histórico fiable. Configurar correctamente la salida de datos te ahorrará horas de trabajo manual y te permitirá ver exactamente qué ocurre bajo el capó.

Requisitos previos

• Permisos de administrador (sudo) para modificar preferencias del sistema.
• Acceso a la terminal de macOS.

Inicio rápido

Para activar los logs locales en formato JSONL, abre el Debug pane y sigue estos 4 pasos:

1. Configura el nivel de detalle en Logs → App logging → Verbosity.
2. Marca la opción “Write rolling diagnostics log (JSONL)”.
3. Localiza el archivo en ~/Library/Logs/OpenClaw/diagnostics.jsonl.
4. Usa el botón “Clear” si necesitas limpiar el historial antes de empezar.

Por defecto, macOS oculta datos privados en los logs. Si necesitas ver payloads completos para depurar bot.molt, instala este archivo plist:

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 necesitas reiniciar. El proceso logd reconocerá el archivo rápido. Puedes ver la salida detallada con tu herramienta habitual: ./scripts/clawlog.sh --category WebChat --last 5m.

Cuando termines de depurar, te recomiendo eliminar el override para proteger tu privacidad: sudo rm /Library/Preferences/Logging/Subsystems/bot.molt.plist

Solución de problemas

• Los datos sensibles aparecen como “private”: El sistema solo aplica el cambio a las nuevas entradas de log. Asegúrate de instalar el archivo plist antes de intentar reproducir el problema.
• El archivo de log no registra nada: Esta función viene desactivada por defecto. Confirma que la opción está marcada en el Debug pane y que tienes permisos de escritura en la carpeta de logs.

AI Setup Assistant

Próximos pasos

• Análisis de archivos JSONL
• Uso de scripts de ayuda para logs