Zum Hauptinhalt springen

​
Protokollierung

Eine benutzerorientierte Übersicht (CLI + Control UI + Konfiguration) finden Sie unter /logging. OpenClaw hat zwei Log-„Oberflächen“:
  • Konsolenausgabe (was Sie im Terminal / in der Debug-UI sehen).
  • Datei-Logs (JSON-Zeilen), die vom Gateway-Logger geschrieben werden.
Beim Start protokolliert der Gateway das aufgelöste Standard-Agentenmodell zusammen mit den Modus-Standardeinstellungen, die neue Sitzungen beeinflussen, zum Beispiel: 
agent model: openai/gpt-5.5 (thinking=medium, fast=on)
thinking stammt vom Standard-Agenten, aus Modellparametern oder aus dem globalen Agentenstandard; wenn es nicht gesetzt ist, zeigt die Startzusammenfassung medium. fast stammt vom Standard-Agenten oder aus den Modellparametern fastMode.

​
Dateibasierter Logger

  • Die standardmäßige rotierende Logdatei liegt unter /tmp/openclaw/ (eine Datei pro Tag): openclaw-YYYY-MM-DD.log
    • Das Datum verwendet die lokale Zeitzone des Gateway-Hosts.
  • Aktive Logdateien rotieren bei logging.maxFileBytes (Standard: 100 MB), wobei bis zu fünf nummerierte Archive behalten werden und in eine neue aktive Datei weitergeschrieben wird.
  • Pfad und Level der Logdatei können über ~/.openclaw/openclaw.json konfiguriert werden:
    • logging.file
    • logging.level
Das Dateiformat ist ein JSON-Objekt pro Zeile. Codepfade für Talk, Echtzeit-Sprache und verwaltete Räume verwenden den gemeinsamen Datei-Logger für begrenzte Lebenszyklusdatensätze. Diese Datensätze sind für operatives Debugging und den OTLP-Logexport gedacht; Transkripttext, Audio-Payloads, Turn-IDs, Call-IDs und Provider-Item-IDs werden nicht in den Logdatensatz kopiert. Der Tab „Logs“ der Control UI verfolgt diese Datei über den Gateway (logs.tail). Die CLI kann dasselbe tun: 
openclaw logs --follow
Ausführlichkeit vs. Log-Level
  • Datei-Logs werden ausschließlich durch logging.level gesteuert.
  • --verbose beeinflusst nur die Ausführlichkeit der Konsole (und den WS-Logstil); es erhöht nicht den Datei-Log-Level.
  • Um Details, die nur bei verbose sichtbar sind, in Datei-Logs zu erfassen, setzen Sie logging.level auf debug oder trace.
  • Trace-Logging enthält außerdem diagnostische Timing-Zusammenfassungen für ausgewählte Hot Paths, zum Beispiel die Vorbereitung der Plugin-Tool-Factory. Siehe /tools/plugin#slow-plugin-tool-setup.

​
Konsolenerfassung

Die CLI erfasst console.log/info/warn/error/debug/trace und schreibt sie in Datei-Logs, während sie weiterhin auf stdout/stderr ausgibt. Sie können die Ausführlichkeit der Konsole unabhängig einstellen über:
  • logging.consoleLevel (Standard info)
  • logging.consoleStyle (pretty | compact | json)

​
Schwärzung

OpenClaw kann vertrauliche Tokens maskieren, bevor Log- oder Transkriptausgaben den Prozess verlassen. Diese Log-Schwärzungsrichtlinie wird auf Konsole, Datei-Log, OTLP- Logdatensatz und Textsenken für Sitzungstranskripte angewendet, sodass passende geheime Werte maskiert werden, bevor JSONL-Zeilen oder Nachrichten auf die Festplatte geschrieben werden.
  • logging.redactSensitive: off | tools (Standard: tools)
  • logging.redactPatterns: Array von Regex-Strings (überschreibt Standards)
    • Verwenden Sie rohe Regex-Strings (automatisch gi) oder /pattern/flags, wenn Sie benutzerdefinierte Flags benötigen.
    • Treffer werden maskiert, indem die ersten 6 + letzten 4 Zeichen beibehalten werden (Länge >= 18), andernfalls ***.
    • Die Standards decken gängige Schlüsselzuweisungen, CLI-Flags, JSON-Felder, Bearer-Header, PEM-Blöcke, verbreitete Token-Präfixe und Feldnamen für Zahlungsdaten wie Kartennummer, CVC/CVV, gemeinsames Zahlungstoken und Zahlungsdaten ab.
Einige Sicherheitsgrenzen schwärzen immer, unabhängig von logging.redactSensitive. Dazu gehören Tool-Call-Ereignisse der Control UI, Tool-Ausgaben von sessions_history, Diagnose-Support-Exporte, Provider-Fehlerbeobachtungen, die Anzeige von Exec-Genehmigungsbefehlen und Gateway-WebSocket-Protokolllogs. Diese Oberflächen können weiterhin logging.redactPatterns als zusätzliche Muster verwenden, aber redactSensitive: "off" führt nicht dazu, dass sie rohe Secrets ausgeben.

​
Gateway-WebSocket-Logs

Der Gateway gibt WebSocket-Protokolllogs in zwei Modi aus:
  • Normaler Modus (kein --verbose): Nur „interessante“ RPC-Ergebnisse werden ausgegeben:
    • Fehler (ok=false)
    • langsame Aufrufe (Standardschwelle: >= 50ms)
    • Parse-Fehler
  • Verbose-Modus (--verbose): Gibt den gesamten WS-Anfrage-/Antwortverkehr aus.

​
WS-Logstil

openclaw gateway unterstützt einen Stil-Umschalter pro Gateway:
  • --ws-log auto (Standard): Normaler Modus ist optimiert; Verbose-Modus verwendet kompakte Ausgabe
  • --ws-log compact: kompakte Ausgabe (gepaarte Anfrage/Antwort) bei verbose
  • --ws-log full: vollständige Ausgabe pro Frame bei verbose
  • --compact: Alias für --ws-log compact
Beispiele: 
# 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

​
Konsolenformatierung (Subsystem-Logging)

Der Konsolenformatierer ist TTY-aware und gibt konsistente, präfixierte Zeilen aus. Subsystem-Logger halten die Ausgabe gruppiert und gut scanbar. Verhalten:
  • Subsystem-Präfixe in jeder Zeile (z. B. [gateway], [canvas], [tailscale])
  • Subsystem-Farben (stabil pro Subsystem) plus Level-Färbung
  • Farbe, wenn die Ausgabe ein TTY ist oder die Umgebung wie ein Rich-Terminal aussieht (TERM/COLORTERM/TERM_PROGRAM), respektiert NO_COLOR
  • Verkürzte Subsystem-Präfixe: entfernt führendes gateway/ + channels/, behält die letzten 2 Segmente (z. B. whatsapp/outbound)
  • Sub-Logger nach Subsystem (automatisches Präfix + strukturiertes Feld { subsystem })
  • logRaw() für QR-/UX-Ausgabe (kein Präfix, keine Formatierung)
  • Konsolenstile (z. B. pretty | compact | json)
  • Konsolen-Log-Level getrennt vom Datei-Log-Level (Datei behält vollständige Details, wenn logging.level auf debug/trace gesetzt ist)
  • WhatsApp-Nachrichtentexte werden auf debug protokolliert (verwenden Sie --verbose, um sie zu sehen)
So bleiben bestehende Datei-Logs stabil, während interaktive Ausgabe gut scanbar wird.

​
Verwandt