openclaw logs

Sigue los logs de archivo de Gateway por RPC (funciona en modo remoto).

Relacionado:

• Descripción general del registro: Registro
• CLI de Gateway: gateway

Opciones

• --limit <n>: número máximo de líneas de log que se devolverán (predeterminado 200)
• --max-bytes <n>: bytes máximos que se leerán del archivo de log (predeterminado 250000)
• --follow: seguir el flujo de logs
• --interval <ms>: intervalo de sondeo mientras se sigue (predeterminado 1000)
• --json: emitir eventos JSON delimitados por líneas
• --plain: salida de texto sin formato sin formato con estilo
• --no-color: desactivar colores ANSI
• --local-time: renderizar marcas de tiempo en tu zona horaria local (predeterminado)
• --utc: renderizar marcas de tiempo en UTC

Opciones RPC compartidas de Gateway

openclaw logs también acepta las marcas estándar del cliente de Gateway:

• --url <url>: URL WebSocket de Gateway
• --token <token>: token de Gateway
• --timeout <ms>: tiempo de espera en ms (predeterminado 30000)
• --expect-final: esperar una respuesta final cuando la llamada de Gateway está respaldada por un agente

Cuando pasas --url, la CLI no aplica automáticamente las credenciales de configuración ni de entorno. Incluye --token explícitamente si el Gateway de destino requiere autenticación.

Ejemplos

openclaw logsopenclaw logs --followopenclaw logs --follow --interval 2000openclaw logs --limit 500 --max-bytes 500000openclaw logs --jsonopenclaw logs --plainopenclaw logs --no-coloropenclaw logs --limit 500openclaw logs --local-timeopenclaw logs --utcopenclaw logs --follow --local-timeopenclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

Notas

• Las marcas de tiempo se renderizan en tu zona horaria local de forma predeterminada. Usa --utc para la salida en UTC.
• Si el Gateway local loopback implícito solicita emparejamiento, se cierra durante la conexión o agota el tiempo de espera antes de que logs.tail responda, openclaw logs recurre automáticamente al log de archivo de Gateway configurado. Los destinos explícitos con --url no usan este respaldo.
• openclaw logs --follow no sigue respaldos de archivo configurado después de fallos RPC implícitos del Gateway local. En Linux, usa el diario de Gateway user-systemd activo por PID cuando está disponible e imprime la fuente de log seleccionada; de lo contrario, sigue reintentando el Gateway en vivo en vez de seguir un archivo adyacente que podría estar obsoleto.
• Al usar --follow, las desconexiones transitorias de Gateway (cierre de WebSocket, tiempo de espera agotado, caída de conexión) activan la reconexión automática con retroceso exponencial (hasta 8 reintentos, con un límite de 30 s entre intentos). Se imprime una advertencia en stderr en cada reintento, y se imprime un aviso [logs] gateway reconnected cuando un sondeo se realiza correctamente. En modo --json, tanto la advertencia de reintento como la transición de reconexión se emiten como registros {"type":"notice"} en stderr. Los errores no recuperables (fallo de autenticación, configuración incorrecta) siguen saliendo inmediatamente.
• En modo --follow --json, las transiciones de fuente de log se emiten como registros {"type":"meta"}. Los consumidores deben seguir los cursores por cada sourceKind: un flujo puede pasar de la salida de archivo de Gateway (sourceKind: "file") al respaldo de diario local (sourceKind: "journal", localFallback: true, con service.pid/service.unit) y volver a la salida de archivo de Gateway después de la recuperación. No asumas una única fuente o cursor estable para toda la sesión de seguimiento, y tolera líneas superpuestas cuando la recuperación reproduce el cursor del archivo de Gateway.

Relacionado

• Referencia de CLI
• Registro de Gateway