Logs

text

Copy

openclaw logs

Tail Gateway file logs over RPC (works in remote mode).

Related:

• Logging overview: Logging
• Gateway CLI: gateway

Options

• text

  Copy

  --limit <n>
  : maximum number of log lines to return (default
  text

  Copy

  200
  )
• text

  Copy

  --max-bytes <n>
  : maximum bytes to read from the log file (default
  text

  Copy

  250000
  )
• text

  Copy

  --follow
  : follow the log stream
• text

  Copy

  --interval <ms>
  : polling interval while following (default
  text

  Copy

  1000
  )
• text

  Copy

  --json
  : emit line-delimited JSON events
• text

  Copy

  --plain
  : plain text output without styled formatting
• text

  Copy

  --no-color
  : disable ANSI colors
• text

  Copy

  --local-time
  : render timestamps in your local timezone

Shared Gateway RPC options

also accepts the standard Gateway client flags:

• text

  Copy

  --url <url>
  : Gateway WebSocket URL
• text

  Copy

  --token <token>
  : Gateway token
• text

  Copy

  --timeout <ms>
  : timeout in ms (default
  text

  Copy

  30000
  )
• text

  Copy

  --expect-final
  : wait for a final response when the Gateway call is agent-backed

When you pass

, the CLI does not auto-apply config or environment credentials. Include explicitly if the target Gateway requires auth.

Examples

bash
Copy
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 --follow --local-time
openclaw logs --url ws://127.0.0.1:18789 --token "$OPENCLAW_GATEWAY_TOKEN"

Notes

• Use
  text

  Copy

  --local-time
  to render timestamps in your local timezone.
• If the implicit local loopback Gateway asks for pairing, closes during connect, or times out before
  text

  Copy

  logs.tail
  answers,
  text

  Copy

  openclaw logs
  falls back to the configured Gateway file log automatically. Explicit
  text

  Copy

  --url
  targets do not use this fallback.

Related

• CLI reference
• Gateway logging