openclaw logs

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

Gerelateerd:

• Overzicht van logging: Logging
• Gateway-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

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"

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
• Gateway-logging