Naar hoofdinhoud gaan

​
Logging

Voor een gebruikersgericht overzicht (CLI + Control UI + configuratie), zie /logging. OpenClaw heeft twee log-”oppervlakken”:
  • Console-uitvoer (wat je ziet in de terminal / Debug UI).
  • Bestandslogs (JSON-regels) geschreven door de Gateway logger.
Bij het opstarten logt de Gateway het opgeloste standaardmodel voor de agent samen met de modusstandaarden die nieuwe sessies beinvloeden, bijvoorbeeld: 
agent model: openai/gpt-5.5 (thinking=medium, fast=on)
thinking komt uit de standaardagent, modelparameters of globale agentstandaard; wanneer dit niet is ingesteld, toont de opstartsamenvatting medium. fast komt uit de standaardagent of modelparameters voor fastMode.

​
Logger op basis van bestanden

  • Het standaard roterende logbestand staat onder /tmp/openclaw/ (een bestand per dag): openclaw-YYYY-MM-DD.log
    • De datum gebruikt de lokale tijdzone van de Gateway host.
  • Actieve logbestanden roteren bij logging.maxFileBytes (standaard: 100 MB), waarbij maximaal vijf genummerde archieven worden bewaard en er naar een nieuw actief bestand wordt geschreven.
  • Het pad en niveau van het logbestand kunnen worden geconfigureerd via ~/.openclaw/openclaw.json:
    • logging.file
    • logging.level
De bestandsindeling is een JSON-object per regel. Codepaden voor Talk, realtime spraak en beheerde ruimtes gebruiken de gedeelde bestandslogger voor begrensde levenscyclusrecords. Deze records zijn bedoeld voor operationele debugging en OTLP-logexport; transcripttekst, audiopayloads, turn-id’s, call-id’s en provider item-id’s worden niet naar het logrecord gekopieerd. Het tabblad Logs in de Control UI volgt dit bestand via de Gateway (logs.tail). De CLI kan hetzelfde doen: 
openclaw logs --follow
Verbose versus logniveaus
  • Bestandslogs worden uitsluitend beheerd door logging.level.
  • --verbose beinvloedt alleen console-uitgebreidheid (en WS-logstijl); het verhoogt het bestandslogniveau niet.
  • Stel logging.level in op debug of trace om details die alleen in verbose-modus verschijnen in bestandslogs vast te leggen.
  • Trace-logging bevat ook diagnostische timingsamenvattingen voor geselecteerde kritieke paden, zoals de voorbereiding van plugin-toolfactories. Zie /tools/plugin#slow-plugin-tool-setup.

​
Consolevastlegging

De CLI legt console.log/info/warn/error/debug/trace vast en schrijft deze naar bestandslogs, terwijl ze nog steeds naar stdout/stderr worden afgedrukt. Je kunt de uitgebreidheid van de console onafhankelijk afstemmen via:
  • logging.consoleLevel (standaard info)
  • logging.consoleStyle (pretty | compact | json)

​
Redactie

OpenClaw kan gevoelige tokens maskeren voordat log- of transcriptuitvoer het proces verlaat. Dit redactiebeleid voor logging wordt toegepast op console-, bestandslog-, OTLP- logrecord- en sessietranscript-tekstuitgangen, zodat overeenkomende geheime waarden worden gemaskeerd voordat JSONL-regels of berichten naar schijf worden geschreven.
  • logging.redactSensitive: off | tools (standaard: tools)
  • logging.redactPatterns: array van regex-strings (overschrijft standaarden)
    • Gebruik ruwe regex-strings (automatisch gi), of /pattern/flags als je aangepaste flags nodig hebt.
    • Overeenkomsten worden gemaskeerd door de eerste 6 + laatste 4 tekens te behouden (lengte >= 18), anders ***.
    • Standaarden dekken gangbare sleuteltoewijzingen, CLI-flags, JSON-velden, bearer-headers, PEM-blokken, populaire tokenprefixen en veldnamen voor betaalgegevens zoals kaartnummer, CVC/CVV, gedeeld betalingstoken en betaalreferentie.
Sommige veiligheidsgrenzen redigeren altijd, ongeacht logging.redactSensitive. Dat omvat tool-call-events van de Control UI, tooluitvoer van sessions_history, diagnostische supportexports, providerfoutobservaties, weergave van exec-goedkeuringsopdrachten en Gateway WebSocket-protocollogs. Deze oppervlakken kunnen nog steeds logging.redactPatterns als aanvullende patronen gebruiken, maar redactSensitive: "off" zorgt er niet voor dat ze ruwe geheimen uitsturen.

​
Gateway WebSocket-logs

De Gateway drukt WebSocket-protocollogs af in twee modi:
  • Normale modus (geen --verbose): alleen “interessante” RPC-resultaten worden afgedrukt:
    • fouten (ok=false)
    • trage calls (standaarddrempel: >= 50ms)
    • parseerfouten
  • Verbose-modus (--verbose): drukt al het WS-aanvraag-/antwoordverkeer af.

​
WS-logstijl

openclaw gateway ondersteunt een stijlschakelaar per Gateway:
  • --ws-log auto (standaard): normale modus is geoptimaliseerd; verbose-modus gebruikt compacte uitvoer
  • --ws-log compact: compacte uitvoer (gekoppeld verzoek/antwoord) wanneer verbose
  • --ws-log full: volledige uitvoer per frame wanneer verbose
  • --compact: alias voor --ws-log compact
Voorbeelden: 
# optimized (only errors/slow)
openclaw gateway

# show all WS traffic (paired)
openclaw gateway --verbose --ws-log compact

# show all WS traffic (full meta)
openclaw gateway --verbose --ws-log full

​
Consoleopmaak (subsysteemlogging)

De consoleformatter is TTY-bewust en drukt consistente, geprefixte regels af. Subsysteemloggers houden uitvoer gegroepeerd en scanbaar. Gedrag:
  • Subsysteemprefixen op elke regel (bijv. [gateway], [canvas], [tailscale])
  • Subsysteemkleuren (stabiel per subsysteem) plus niveaukleuren
  • Kleur wanneer uitvoer een TTY is of de omgeving op een rijke terminal lijkt (TERM/COLORTERM/TERM_PROGRAM), respecteert NO_COLOR
  • Verkorte subsysteemprefixen: laat voorloop gateway/ + channels/ vallen, behoudt de laatste 2 segmenten (bijv. whatsapp/outbound)
  • Subloggers per subsysteem (automatisch prefix + gestructureerd veld { subsystem })
  • logRaw() voor QR/UX-uitvoer (geen prefix, geen opmaak)
  • Consolestijlen (bijv. pretty | compact | json)
  • Consolelogniveau los van bestandslogniveau (bestand behoudt volledige details wanneer logging.level is ingesteld op debug/trace)
  • WhatsApp-berichtinhoud wordt gelogd op debug (gebruik --verbose om deze te zien)
Dit houdt bestaande bestandslogs stabiel terwijl interactieve uitvoer scanbaar wordt.

​
Gerelateerd