# Journalisation

Pour une vue d’ensemble destinée aux utilisateurs (CLI + interface de contrôle + configuration), consultez /logging.

OpenClaw dispose de deux « surfaces » de journaux :

• Sortie console (ce que vous voyez dans le terminal / l’interface Debug).
• Journaux de fichiers (lignes JSON) écrits par le journaliseur du Gateway.

Au démarrage, le Gateway consigne le modèle d’agent par défaut résolu avec les valeurs par défaut du mode qui affectent les nouvelles sessions, par exemple :

agent model: openai-codex/gpt-5.5 (thinking=medium, fast=on)

thinking provient de l’agent par défaut, des paramètres du modèle ou de la valeur par défaut globale de l’agent ; lorsqu’il n’est pas défini, le résumé de démarrage affiche medium. fast provient de l’agent par défaut ou des paramètres fastMode du modèle.

# Journaliseur basé sur des fichiers

• Le fichier journal rotatif par défaut se trouve sous /tmp/openclaw/ (un fichier par jour) : openclaw-YYYY-MM-DD.log
  • La date utilise le fuseau horaire local de l’hôte du Gateway.
• Les fichiers journaux actifs tournent à logging.maxFileBytes (par défaut : 100 MB), en conservant jusqu’à cinq archives numérotées et en continuant à écrire dans un nouveau fichier actif.
• Le chemin et le niveau du fichier journal peuvent être configurés via ~/.openclaw/openclaw.json :
  • logging.file
  • logging.level

Le format du fichier est d’un objet JSON par ligne.

Les chemins de code de conversation, de voix en temps réel et de salon géré utilisent le journaliseur de fichiers partagé pour des enregistrements de cycle de vie bornés. Ces enregistrements sont destinés au débogage opérationnel et à l’exportation des journaux OTLP ; le texte de transcription, les charges utiles audio, les identifiants de tour, les identifiants d’appel et les identifiants d’éléments de fournisseur ne sont pas copiés dans l’enregistrement de journal.

L’onglet Journaux de l’interface de contrôle suit ce fichier via le Gateway (logs.tail). La CLI peut faire la même chose :

openclaw logs --follow

Verbeux ou niveaux de journal

• Les journaux de fichiers sont contrôlés exclusivement par logging.level.
• --verbose n’affecte que la verbosité de la console (et le style des journaux WS) ; il ne relève pas le niveau de journal des fichiers.
• Pour capturer les détails réservés au mode verbeux dans les journaux de fichiers, définissez logging.level sur debug ou trace.
• La journalisation de trace inclut également des résumés de minutage de diagnostic pour certains chemins critiques, comme la préparation des fabriques d’outils de Plugin. Consultez /tools/plugin#slow-plugin-tool-setup.

# Capture de la console

La CLI capture console.log/info/warn/error/debug/trace et les écrit dans les journaux de fichiers, tout en continuant à les afficher sur stdout/stderr.

Vous pouvez régler la verbosité de la console indépendamment via :

• logging.consoleLevel (par défaut info)
• logging.consoleStyle (pretty | compact | json)

# Caviardage

OpenClaw peut masquer les jetons sensibles avant que la sortie de journal ou de transcription ne quitte le processus. Cette politique de caviardage de la journalisation s’applique aux sorties de texte de console, de fichier journal, d’enregistrements de journal OTLP et de transcription de session, de sorte que les valeurs secrètes correspondantes sont masquées avant que les lignes JSONL ou les messages soient écrits sur le disque.

• logging.redactSensitive : off | tools (par défaut : tools)
• logging.redactPatterns : tableau de chaînes regex (remplace les valeurs par défaut)
  • Utilisez des chaînes regex brutes (gi automatique), ou /pattern/flags si vous avez besoin d’indicateurs personnalisés.
  • Les correspondances sont masquées en conservant les 6 premiers + les 4 derniers caractères (longueur >= 18), sinon ***.
  • Les valeurs par défaut couvrent les affectations de clés courantes, les indicateurs CLI, les champs JSON, les en-têtes bearer, les blocs PEM, les préfixes de jetons populaires et les noms de champs d’identifiants de paiement tels que numéro de carte, CVC/CVV, jeton de paiement partagé et identifiant de paiement.

Certaines limites de sécurité caviardent toujours, quelle que soit la valeur de logging.redactSensitive. Cela inclut les événements d’appel d’outil de l’interface de contrôle, la sortie de l’outil sessions_history, les exportations de support de diagnostic, les observations d’erreur de fournisseur, l’affichage des commandes d’approbation d’exécution et les journaux de protocole WebSocket du Gateway. Ces surfaces peuvent toujours utiliser logging.redactPatterns comme motifs supplémentaires, mais redactSensitive: "off" ne leur fait pas émettre de secrets bruts.

# Journaux WebSocket du Gateway

Le Gateway affiche les journaux du protocole WebSocket dans deux modes :

• Mode normal (sans --verbose) : seuls les résultats RPC « intéressants » sont affichés :
  • erreurs (ok=false)
  • appels lents (seuil par défaut : >= 50ms)
  • erreurs d’analyse
• Mode verbeux (--verbose) : affiche tout le trafic de requête/réponse WS.

# Style de journal WS

openclaw gateway prend en charge un commutateur de style par Gateway :

• --ws-log auto (par défaut) : le mode normal est optimisé ; le mode verbeux utilise une sortie compacte
• --ws-log compact : sortie compacte (requête/réponse appariées) en mode verbeux
• --ws-log full : sortie complète 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

# Mise en forme de la console (journalisation des sous-systèmes)

Le formateur de console est compatible TTY et affiche des lignes cohérentes avec préfixe. Les journaliseurs de sous-systèmes gardent la sortie groupée et lisible.

Comportement :

• Préfixes de sous-système sur chaque ligne (par ex. [gateway], [canvas], [tailscale])
• Couleurs de sous-système (stables par sous-système) plus coloration du niveau
• Couleur lorsque la sortie est un TTY ou que l’environnement ressemble à un terminal riche (TERM/COLORTERM/TERM_PROGRAM), respecte NO_COLOR
• Préfixes de sous-système raccourcis : supprime les préfixes initiaux gateway/ + channels/, conserve les 2 derniers segments (par ex. whatsapp/outbound)
• Sous-journaliseurs par sous-système (préfixe automatique + champ structuré { subsystem })
• logRaw() pour la sortie QR/UX (sans préfixe, sans mise en forme)
• Styles de console (par ex. pretty | compact | json)
• Niveau de journal de console séparé du niveau de journal de fichier (le fichier conserve le niveau de détail complet lorsque logging.level est défini sur debug/trace)
• Les corps de messages WhatsApp sont journalisés au niveau debug (utilisez --verbose pour les voir)

Cela maintient la stabilité des journaux de fichiers existants tout en rendant la sortie interactive lisible.

# Associé

• Journalisation
• Export OpenTelemetry
• Export de diagnostics