Journalisation¶

Pour une vue d’ensemble orientee utilisateur (CLI + UI de controle + configuration), voir /logging.

OpenClaw propose deux « surfaces » de journalisation :

• Sortie console (ce que vous voyez dans le terminal / l’UI de debug).
• Journaux de fichiers (lignes JSON) ecrits par le logger de la Gateway (passerelle).

Logger base sur des fichiers¶

• Le fichier de journalisation tournant par defaut se trouve sous /tmp/openclaw/ (un fichier par jour) : openclaw-YYYY-MM-DD.log
• La date utilise le fuseau horaire local de l’hote de la passerelle.
• Le chemin du fichier de logs et le niveau peuvent etre configures via ~/.openclaw/openclaw.json :
• logging.file
• logging.level

Le format du fichier est un objet JSON par ligne.

L’onglet Logs de l’UI de controle suit ce fichier via la passerelle (logs.tail). Le CLI peut faire de meme :

openclaw logs --follow

Verbose vs. niveaux de logs

• Les journaux de fichiers sont controles exclusivement par logging.level.
• --verbose affecte uniquement la verbeuxite de la console (et le style de logs WS) ; il n’augmente pas le niveau des journaux de fichiers.
• Pour capturer des details uniquement verbeux dans les journaux de fichiers, definissez logging.level sur debug ou trace.

Capture de la console¶

Le CLI capture console.log/info/warn/error/debug/trace et les ecrit dans les journaux de fichiers, tout en continuant a les afficher sur stdout/stderr.

Vous pouvez ajuster independamment la verbeuxite de la console via :

• logging.consoleLevel (par defaut info)
• logging.consoleStyle (pretty | compact | json)

Redaction des resumes d’outils¶

Les resumes d’outils verbeux (par ex. 🛠️ Exec: ...) peuvent masquer les jetons sensibles avant qu’ils n’atteignent le flux de la console. Cela concerne uniquement les outils et ne modifie pas les journaux de fichiers.

• logging.redactSensitive : off | tools (par defaut : tools)
• logging.redactPatterns : tableau de chaines regex (remplace les valeurs par defaut)
• Utilisez des chaines regex brutes (auto gi), ou /pattern/flags si vous avez besoin de drapeaux personnalises.
• Les correspondances sont masquees en conservant les 6 premiers + les 4 derniers caracteres (longueur >= 18), sinon ***.
• Les valeurs par defaut couvrent les affectations de cles courantes, les drapeaux CLI, les champs JSON, les en-tetes bearer, les blocs PEM et les prefixes de jetons populaires.

Journaux WebSocket de la Gateway (passerelle)¶

La passerelle affiche les journaux du protocole WebSocket selon deux modes :

• Mode normal (sans --verbose) : seuls les resultats RPC « interessants » sont affiches :
• erreurs (ok=false)
• appels lents (seuil par defaut : >= 50ms)
• erreurs d’analyse
• Mode verbeux (--verbose) : affiche tout le trafic requete/reponse WS.

Style de logs WS¶

openclaw gateway prend en charge un changement de style par passerelle :

• --ws-log auto (par defaut) : le mode normal est optimise ; le mode verbeux utilise une sortie compacte
• --ws-log compact : sortie compacte (requete/reponse appariees) en mode verbeux
• --ws-log full : sortie complete par trame en mode verbeux
• --compact : alias de --ws-log compact

Exemples :

# 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

Formatage de la console (journalisation par sous-systeme)¶

Le formateur de console est conscient du TTY et affiche des lignes coherentes avec des prefixes. Les loggers de sous-systemes conservent une sortie regroupee et facilement lisible.

Comportement :

• Prefixes de sous-systeme sur chaque ligne (par ex. [gateway], [canvas], [tailscale])
• Couleurs par sous-systeme (stables par sous-systeme) en plus de la coloration par niveau
• Couleur lorsque la sortie est un TTY ou que l’environnement ressemble a un terminal riche (TERM/COLORTERM/TERM_PROGRAM), respecte NO_COLOR
• Prefixes de sous-systeme raccourcis : supprime les prefixes initiaux gateway/ + channels/, conserve les 2 derniers segments (par ex. whatsapp/outbound)
• Sous-loggers par sous-systeme (prefixe automatique + champ structure { subsystem })
• logRaw() pour la sortie QR/UX (pas de prefixe, pas de formatage)
• Styles de console (par ex. pretty | compact | json)
• Niveau de logs console distinct du niveau de logs fichiers (le fichier conserve tous les details lorsque logging.level est defini sur debug/trace)
• Les corps de messages WhatsApp sont journalises au niveau debug (utilisez --verbose pour les voir)

Cela permet de conserver des journaux de fichiers stables tout en rendant la sortie interactive facilement analysable.