Gestión de logs en OpenClaw

¿Alguna vez has pasado demasiado tiempo buscando por qué falló una ejecución, solo para encontrar el error perdido en un mar de texto sin formato? No tienes que adivinar qué está pasando en tu sistema. Una buena estrategia de logs te permite identificar problemas en segundos sin perder la paciencia frente a la terminal.

Requisitos previos

• Archivo de configuración ~/.openclaw/openclaw.json disponible.
• Acceso al directorio /tmp/openclaw/ para consultar los archivos locales.

Inicio rápido

Para ver qué está pasando en tu sistema ahora mismo, usa el comando de seguimiento en tu terminal. Es la ruta más corta para obtener visibilidad:

openclaw logs --follow

Este comando hace un tail de los logs directamente desde el Gateway. Si prefieres la interfaz gráfica, también puedes ver esta misma información en la pestaña Logs del Control UI.

File-based logger

OpenClaw escribe logs en formato JSON lines de forma automática. Por defecto, los archivos se guardan en /tmp/openclaw/ y se genera uno nuevo cada día siguiendo el formato openclaw-YYYY-MM-DD.log.

Si quieres cambiar la ubicación o el nivel de detalle, edita tu configuración en ~/.openclaw/openclaw.json:

• logging.file: Define la ruta del archivo.
• logging.level: Ajusta el nivel (ej. info, debug, trace).

Diferencia entre Verbose y Log Levels Es importante que no te confundas: el flag --verbose solo afecta lo que ves en la consola. Para capturar detalles técnicos profundos en los archivos físicos, debes configurar logging.level como debug o trace.

Captura de consola y privacidad

El CLI captura todas las salidas de console.log y sus variantes para escribirlas en los archivos, pero sigue imprimiendo en stdout y stderr para que no pierdas el rastro mientras trabajas.

Redacción de datos sensibles

Para evitar que tus tokens o credenciales aparezcan en la pantalla, OpenClaw incluye un sistema de redacción. Esto solo afecta a la consola y no modifica los archivos de log:

• logging.redactSensitive: Configúralo en tools para ocultar secretos.
• logging.redactPatterns: Puedes añadir tus propios regex para filtrar datos específicos.

Cuando el sistema detecta un token largo (más de 18 caracteres), mantiene los primeros 6 y los últimos 4, ocultando el resto. Si es más corto, usa ***.

Logs del Gateway (WebSocket)

El Gateway maneja logs específicos para el protocolo WebSocket. Tienes dos modos principales de operación:

1. Modo Normal: Solo verás errores (ok=false) y llamadas lentas que superen los 50ms.
2. Modo Verbose: Muestra todo el tráfico de peticiones y respuestas.

Puedes cambiar el estilo visual con estos comandos:

# Solo errores y llamadas lentas
openclaw gateway

# Tráfico completo con formato compacto
openclaw gateway --verbose --ws-log compact

# Tráfico completo con metadatos detallados
openclaw gateway --verbose --ws-log full

Formateo y subsistemas

La consola de OpenClaw es inteligente y detecta si tu terminal soporta colores (TTY). Para que la lectura sea sencilla, utiliza un sistema de prefijos por subsistema:

• Prefijos claros: Verás etiquetas como [gateway] o [canvas] al inicio de cada línea.
• Colores estables: Cada subsistema tiene un color asignado para que los identifiques visualmente.
• Estilos configurables: Puedes elegir entre pretty, compact o json mediante logging.consoleStyle.
• Logs de WhatsApp: Los cuerpos de los mensajes se registran en nivel debug. Usa --verbose si necesitas inspeccionarlos.

Solución de problemas

• El archivo de log no muestra detalles de debug pero la consola sí. El flag --verbose no afecta a los archivos. Debes cambiar manualmente logging.level a debug en tu archivo openclaw.json.

• Los logs de WebSocket saturan la terminal. Estás usando el modo verbose. Ejecuta el Gateway sin el flag --verbose o usa --ws-log compact para agrupar las peticiones y respuestas en una sola línea.

AI Setup Assistant

Próximos pasos

• /logging