docs/docs/fr/gateway/logging.md

read_when	summary	title	x-i18n
Modification de la sortie ou des formats de journalisation Débogage de la sortie de la CLI ou du Gateway	Surfaces de journalisation, journaux de fichiers, styles de journaux WS et mise en forme de la console	Journalisation du Gateway	generated_at model provider source_hash source_path workflow 2026-05-02T07:07:12Z gpt-5.5 openai eb5f5ccd77909e82bd2938a33514ce8361c69910eb945c731d9b2c8266174c13 gateway/logging.md 16

Journalisation

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

OpenClaw possède deux « surfaces » de journalisation :

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

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 sont remplacés à logging.maxFileBytes (par défaut : 100 Mo), 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 de fichier est d’un objet JSON par ligne.

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

Verbosité vs niveaux de journalisation

• Les journaux de fichiers sont contrôlés exclusivement par logging.level.
• --verbose affecte uniquement la verbosité de la console (et le style des journaux WS) ; il ne relève pas le niveau de journalisation des fichiers.
• Pour capturer dans les journaux de fichiers les détails visibles uniquement en mode verbeux, 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 de la fabrique d’outils de Plugin. Voir /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 imprimer vers stdout/stderr.

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

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

Biffage

OpenClaw peut masquer les jetons sensibles avant que la sortie de journal ou de transcription ne quitte le processus. Cette politique de biffage de journalisation est appliquée aux sorties console, journaux de fichiers, enregistrements de journaux OTLP et texte de transcription de session, afin que les valeurs secrètes correspondantes soient masquées avant l’écriture des lignes JSONL ou des messages sur 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 + 4 derniers caractères (longueur >= 18), sinon ***.
  • Les valeurs par défaut couvrent les affectations de clés courantes, les options 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é biffent toujours, quelle que soit la valeur de logging.redactSensitive. Cela inclut les événements d’appels d’outils de l’interface de contrôle, la sortie de l’outil sessions_history, les exports de support de diagnostics, les observations d’erreurs de fournisseurs, l’affichage des commandes d’approbation exec et les journaux du 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 imprime les journaux du protocole WebSocket dans deux modes :

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

Style de journal WS

openclaw gateway prend en charge un sélecteur 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 associé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

Formatage de la console (journalisation par sous-système)

Le formateur de console est sensible au TTY et imprime des lignes cohérentes et préfixées. Les journaliseurs de sous-systèmes gardent la sortie groupée et facile à parcourir.

Comportement :

• Préfixes de sous-système sur chaque ligne (p. ex. [gateway], [canvas], [tailscale])
• Couleurs de sous-système (stables par sous-système) plus coloration par 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 gateway/ + channels/, conserve les 2 derniers segments (p. ex. whatsapp/outbound)
• Sous-journaliseurs par sous-système (préfixe automatique + champ structuré { subsystem })
• logRaw() pour les sorties QR/UX (pas de préfixe, pas de formatage)
• Styles de console (p. ex. pretty | compact | json)
• Niveau de journalisation console distinct du niveau de journalisation des fichiers (le fichier conserve tous les détails lorsque logging.level est défini sur debug/trace)
• Les corps de messages WhatsApp sont journalisés à debug (utilisez --verbose pour les voir)

Cela garde les journaux de fichiers existants stables tout en rendant la sortie interactive facile à parcourir.

Liens connexes

• Journalisation
• Export OpenTelemetry
• Export des diagnostics