Saltar al contenido principal

​
openclaw logs

Sigue los registros de archivo del Gateway mediante RPC. Funciona en modo remoto.

​
Opciones

  • --limit <n>: máximo de líneas de registro que se devolverán (predeterminado 200)
  • --max-bytes <n>: máximo de bytes que se leerán del archivo de registro (predeterminado 250000)
  • --follow: seguir el flujo de registros
  • --interval <ms>: intervalo de sondeo durante el seguimiento (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: mostrar marcas de tiempo en tu zona horaria local (predeterminado)
  • --utc: mostrar marcas de tiempo en UTC

​
Opciones RPC compartidas del Gateway

  • --url <url>: URL WebSocket del Gateway
  • --token <token>: token del Gateway
  • --timeout <ms>: tiempo de espera en ms (predeterminado 30000)
  • --expect-final: esperar una respuesta final cuando la llamada al Gateway esté respaldada por un agente
Pasar --url omite las credenciales de configuración aplicadas automáticamente; incluye --token explícitamente si el Gateway de destino requiere autenticación.

​
Ejemplos

openclaw logs
openclaw logs --follow
openclaw logs --follow --interval 2000
openclaw logs --limit 500 --max-bytes 500000
openclaw logs --json
openclaw logs --plain
openclaw logs --no-color
openclaw logs --utc
openclaw logs --follow --local-time
openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

​
Comportamiento de reserva y recuperación

  • Si el Gateway de 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 registro de archivo del Gateway configurado. Los destinos --url explícitos nunca usan esta reserva.
  • --follow no recurre a ese archivo configurado después de una falla RPC implícita del Gateway local: un archivo paralelo obsoleto podría inducir a error en un seguimiento en vivo. En Linux, en su lugar usa el diario activo del Gateway de user-systemd por PID cuando está disponible (imprime la fuente seleccionada); de lo contrario, sigue reintentando el Gateway en vivo.
  • Durante --follow, las desconexiones transitorias (cierre de WebSocket, tiempo de espera, 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 una encuesta tiene éxito. En modo --json, ambos se emiten como registros {"type":"notice"} en stderr. Los errores no recuperables (falla de autenticación, configuración incorrecta) todavía salen de inmediato.
  • En modo --follow --json, las transiciones de fuente de registro se emiten como registros {"type":"meta"}. Rastrea cursores por sourceKind: un flujo puede pasar de la salida del archivo del Gateway (sourceKind: "file") a la reserva del diario local (sourceKind: "journal", localFallback: true, con service.pid/service.unit) y volver a la salida del archivo del Gateway después de la recuperación. No asumas una única fuente o cursor estable para toda la sesión, y tolera líneas superpuestas cuando la recuperación reproduce el cursor del archivo del Gateway.

​
Relacionado