> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Registros

# `openclaw logs`

Acompanhe logs de arquivo do Gateway por RPC (funciona em modo remoto).

Relacionado:

* Visão geral de logs: [Logs](/pt-BR/logging)
* CLI do Gateway: [gateway](/pt-BR/cli/gateway)

## Opções

* `--limit <n>`: número máximo de linhas de log a retornar (padrão `200`)
* `--max-bytes <n>`: máximo de bytes a ler do arquivo de log (padrão `250000`)
* `--follow`: acompanhar o fluxo de logs
* `--interval <ms>`: intervalo de polling ao acompanhar (padrão `1000`)
* `--json`: emitir eventos JSON delimitados por linha
* `--plain`: saída em texto simples sem formatação estilizada
* `--no-color`: desativar cores ANSI
* `--local-time`: renderizar timestamps no seu fuso horário local (padrão)
* `--utc`: renderizar timestamps em UTC

## Opções RPC compartilhadas do Gateway

`openclaw logs` também aceita as flags padrão do cliente Gateway:

* `--url <url>`: URL WebSocket do Gateway
* `--token <token>`: token do Gateway
* `--timeout <ms>`: timeout em ms (padrão `30000`)
* `--expect-final`: aguardar uma resposta final quando a chamada ao Gateway tiver respaldo de agente

Quando você passa `--url`, a CLI não aplica automaticamente credenciais de configuração ou ambiente. Inclua `--token` explicitamente se o Gateway de destino exigir autenticação.

## Exemplos

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 --limit 500
openclaw logs --local-time
openclaw logs --utc
openclaw logs --follow --local-time
openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"
```

## Observações

* Por padrão, os timestamps são renderizados no seu fuso horário local. Use `--utc` para saída em UTC.
* Se o Gateway local loopback implícito solicitar pareamento, fechar durante a conexão ou atingir timeout antes de `logs.tail` responder, `openclaw logs` recorre automaticamente ao log de arquivo configurado do Gateway. Destinos `--url` explícitos não usam esse fallback.
* `openclaw logs --follow` não acompanha fallbacks de arquivo configurado após falhas de RPC do Gateway local implícito. No Linux, ele usa o journal ativo do Gateway de user-systemd por PID quando disponível e imprime a fonte de log selecionada; caso contrário, continua tentando novamente o Gateway ativo em vez de acompanhar um arquivo lado a lado potencialmente obsoleto.
* Ao usar `--follow`, desconexões transitórias do gateway (fechamento de WebSocket, timeout, queda de conexão) acionam reconexão automática com backoff exponencial (até 8 tentativas, limitado a 30 s entre tentativas). Um aviso é impresso em stderr a cada nova tentativa, e um aviso `[logs] gateway reconnected` é impresso assim que um polling tem sucesso. No modo `--json`, tanto o aviso de nova tentativa quanto a transição de reconexão são emitidos como registros `{"type":"notice"}` em stderr. Erros não recuperáveis (falha de autenticação, configuração inválida) ainda encerram imediatamente.
* No modo `--follow --json`, transições da fonte de log são emitidas como registros `{"type":"meta"}`. Consumidores devem rastrear cursores por `sourceKind`: um fluxo pode passar da saída de arquivo do Gateway (`sourceKind: "file"`) para o fallback de journal local (`sourceKind: "journal"`, `localFallback: true`, com `service.pid`/`service.unit`) e voltar para a saída de arquivo do Gateway após a recuperação. Não presuma uma única fonte ou cursor estável para toda a sessão de acompanhamento, e tolere linhas sobrepostas quando a recuperação reproduzir novamente o cursor do arquivo do Gateway.

## Relacionado

* [Referência da CLI](/pt-BR/cli)
* [Logs do Gateway](/pt-BR/gateway/logging)