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.