Hoppa till huvudinnehåll

​
Loggning

För en användarnära översikt (CLI + Control UI + konfig), se /logging. OpenClaw har två logg-”ytor”:
  • Konsolutdata (det du ser i terminalen / Debug UI).
  • Filloggar (JSON-rader) som skrivs av gateway-loggaren.

​
Filbaserad logger

  • Standard roterande loggfil finns under /tmp/openclaw/ (en fil per dag): openclaw-YYYY-MM-DD.log
    • Datum använder gateway-värdens lokala tidszon.
  • Loggfilens sökväg och nivå kan konfigureras via ~/.openclaw/openclaw.json:
    • logging.file
    • logging.level
Filformatet är ett JSON-objekt per rad. Fliken Control UI Logs svansar den här filen via gateway (logs.tail). CLI kan göra detsamma: 
openclaw logs --follow
Utförlig kontra loggnivåer
  • Filloggar styrs uteslutande av logging.level.
  • --verbose påverkar endast konsolens utförlighet (och WS-loggstil); den höjer inte filloggarnas nivå.
  • För att fånga detaljer som bara visas i utförligt läge i filloggar, sätt logging.level till debug eller trace.

​
Konsolinfångning

CLI fångar console.log/info/warn/error/debug/trace och skriver dem till filloggar, samtidigt som de fortfarande skrivs till stdout/stderr. Du kan justera konsolens utförlighet oberoende via:
  • logging.consoleLevel (standard info)
  • logging.consoleStyle (pretty | compact | json)

​
Maskning av verktygssammanfattningar

Verkta verktygssammanfattningar (t.ex. 🛠️ Exec: ...) kan maskera känsliga polletter innan de träffar konsolströmmen. Detta är verktyg och ändrar inte filloggar.
  • logging.redactSensitive: off | tools (standard: tools)
  • logging.redactPatterns: array av regex-strängar (åsidosätter standardvärden)
    • Använd råa regex-strängar (auto gi), eller /pattern/flags om du behöver egna flaggor.
    • Träffar maskeras genom att behålla de första 6 + sista 4 tecknen (längd >= 18), annars ***.
    • Standardvärden täcker vanliga nyckeltilldelningar, CLI-flaggor, JSON-fält, bearer-headers, PEM-block och populära tokenprefix.

​
Gateway WebSocket-loggar

Gateway skriver WebSocket-protokollloggar i två lägen:
  • Normalt läge (utan --verbose): endast ”intressanta” RPC-resultat skrivs:
    • fel (ok=false)
    • långsamma anrop (standardtröskel: >= 50ms)
    • tolkningsfel
  • Utförligt läge (--verbose): skriver all WS-begäran-/svarstrafik.

​
WS-loggstil

openclaw gateway stödjer ett stilbyte per gateway:
  • --ws-log auto (standard): normalt läge är optimerat; utförligt läge använder kompakt utdata
  • --ws-log compact: kompakt utdata (parad begäran/svar) vid utförligt
  • --ws-log full: fullständig per-ram-utdata vid utförligt
  • --compact: alias för --ws-log compact
Exempel: 
# 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

​
Konsolformatering (delsystemloggning)

Konsolformatteraren är TTY-aware och skriver ut konsekventa, prefixa linjer. Undersystemsloggar håller utdata grupperade och skannbara. Beteende:
  • Prefix för delsystemet** på varje rad (t.ex. [gateway], [canvas], [tailscale])
  • Delsystemfärger (stabila per delsystem) plus nivåfärgning
  • Färg när utdata är en TTY eller miljön ser ut som en rik terminal (TERM/COLORTERM/TERM_PROGRAM), respekterar NO_COLOR
  • Förkortade delsystemprefix: droppar ledande gateway/ + kanaler/, håller de sista 2 segmenten (t.ex. whatsapp/outbound)
  • Underloggare per delsystem (auto-prefix + strukturerat fält { subsystem })
  • logRaw() för QR/UX-utdata (inget prefix, ingen formatering)
  • Konsolstilar (t.ex. pretty <unk> compact <unk> json)
  • Konsollognivå separat från fillognivå (filen behåller full detalj när logging.level är satt till debug/trace)
  • WhatsApp-meddelandekroppar loggas på debug (använd --verbose för att se dem)
Detta håller befintliga filloggar stabila samtidigt som interaktiv utdata blir lätt att skanna.