> ## 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.

# Logboeken

# `openclaw logs`

Volg Gateway-bestandslogs via RPC (werkt in externe modus).

Gerelateerd:

* Overzicht van logging: [Logging](/nl/logging)
* Gateway-CLI: [gateway](/nl/cli/gateway)

## Opties

* `--limit <n>`: maximaal aantal logregels om terug te geven (standaard `200`)
* `--max-bytes <n>`: maximaal aantal bytes om uit het logbestand te lezen (standaard `250000`)
* `--follow`: volg de logstream
* `--interval <ms>`: pollinginterval tijdens het volgen (standaard `1000`)
* `--json`: geef regelgescheiden JSON-gebeurtenissen uit
* `--plain`: uitvoer in platte tekst zonder gestileerde opmaak
* `--no-color`: schakel ANSI-kleuren uit
* `--local-time`: render tijdstempels in je lokale tijdzone (standaard)
* `--utc`: render tijdstempels in UTC

## Gedeelde Gateway-RPC-opties

`openclaw logs` accepteert ook de standaard Gateway-clientvlaggen:

* `--url <url>`: Gateway-WebSocket-URL
* `--token <token>`: Gateway-token
* `--timeout <ms>`: timeout in ms (standaard `30000`)
* `--expect-final`: wacht op een definitieve respons wanneer de Gateway-aanroep door een agent wordt ondersteund

Wanneer je `--url` meegeeft, past de CLI config- of omgevingsreferenties niet automatisch toe. Voeg `--token` expliciet toe als de doel-Gateway auth vereist.

## Voorbeelden

```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"
```

## Opmerkingen

* Tijdstempels worden standaard in je lokale tijdzone gerenderd. Gebruik `--utc` voor UTC-uitvoer.
* Als de impliciete local loopback Gateway om koppeling vraagt, tijdens het verbinden sluit, of een timeout krijgt voordat `logs.tail` antwoordt, valt `openclaw logs` automatisch terug op het geconfigureerde Gateway-bestandslog. Expliciete `--url`-doelen gebruiken deze fallback niet.
* `openclaw logs --follow` volgt geen geconfigureerde-bestandsfallbacks na impliciete lokale Gateway-RPC-fouten. Op Linux gebruikt het, wanneer beschikbaar, het actieve user-systemd Gateway-journal per PID en print het de geselecteerde logbron; anders blijft het de live Gateway opnieuw proberen in plaats van een mogelijk verouderd naastgelegen bestand te volgen.
* Bij gebruik van `--follow` activeren tijdelijke Gateway-verbindingverbrekingen (WebSocket-sluiting, timeout, weggevallen verbinding) automatische herverbinding met exponentiële backoff (tot 8 nieuwe pogingen, begrensd op 30 s tussen pogingen). Bij elke nieuwe poging wordt een waarschuwing naar stderr geprint, en zodra een poll slaagt wordt een melding `[logs] gateway reconnected` geprint. In `--json`-modus worden zowel de waarschuwing voor de nieuwe poging als de herverbindingsovergang als `{"type":"notice"}`-records op stderr uitgegeven. Niet-herstelbare fouten (auth-fout, ongeldige configuratie) sluiten nog steeds direct af.
* In `--follow --json`-modus worden overgangen van logbron uitgegeven als `{"type":"meta"}`-records. Consumers moeten cursors per `sourceKind` bijhouden: een stream kan van Gateway-bestandsuitvoer (`sourceKind: "file"`) naar lokale journal-fallback (`sourceKind: "journal"`, `localFallback: true`, met `service.pid`/`service.unit`) gaan en na herstel terug naar Gateway-bestandsuitvoer. Ga niet uit van één stabiele bron of cursor voor de hele volgsessie, en tolereer overlappende regels wanneer herstel de Gateway-bestandscursor opnieuw afspeelt.

## Gerelateerd

* [CLI-referentie](/nl/cli)
* [Gateway-logging](/nl/gateway/logging)