Les journaux d’OpenClaw

OpenClaw a deux surfaces de journaux : des fichiers JSON par lignes écrits par la passerelle, et la sortie console du terminal qui la fait tourner. L’onglet Journaux de l’interface de contrôle suit le fichier, et la commande de journaux fait de même par RPC. La plupart des dépannages de la documentation finissent par l’un de ces trois, voici donc où vivent les fichiers, comment ils tournent et disparaissent, comment les suivre, et quoi lire quand la passerelle elle-même refuse de démarrer.

Où ils vivent

• Un fichier tournant par jour sous un répertoire temporaire au nom d’OpenClaw, avec la date dans le nom de fichier ; les profils nommés reçoivent un nom qualifié par le profil, et le raccourci dev écrit son propre fichier.
• Quand ce répertoire n’est pas sûr ou indisponible, et toujours sous Windows, un répertoire propre à l’utilisateur sous le répertoire temporaire du système est utilisé à la place ; la date suit le fuseau horaire local de l’hôte.
• Un fichier tourne quand l’écriture suivante dépasserait 100 mégaoctets, avec jusqu’à cinq archives numérotées gardées à côté du fichier actif, et le chemin peut être remplacé dans le bloc de journalisation de la configuration.

Les fichiers de journaux datés sont purgés après 24 heures.

Comment les lire

La commande de journaux avec l’option de suivi suit le fichier de la passerelle par RPC, en se reconnectant avec un délai croissant, et les sélecteurs dev et profil résolvent le même fichier que la passerelle écrit, avec un repli sur la lecture directe du fichier quand le RPC local est indisponible. Les options couvrent les lignes par lecture, 200 par défaut, les octets par lecture, l’intervalle d’interrogation, le JSON par lignes, le texte brut, l’absence de couleur et les horodatages en UTC. L’interface de contrôle montre le même suivi dans son onglet Journaux.

Quand quelque chose ne va pas

• Une configuration invalide signifie que la passerelle ne démarre pas et que seules les commandes de diagnostic fonctionnent : docteur, journaux, santé et état, dans cet ordre d’utilité.
• Sur un hôte systemd, le journal du service est l’autre endroit où regarder, et les pages de plateforme le disent pour chaque chemin d’installation, du VPS au Pi.
• La purge au bout d’un jour signifie qu’un problème de la semaine dernière n’a plus de fichier ; copiez le fichier ailleurs quand une panne est intermittente.

OpenClaw ne répond pas est l’échelle par symptôme qui finit dans ces fichiers, et Les commandes de terminal d’OpenClaw liste les commandes à côté de celle des journaux.

Niveaux, formats, expurgation

Le reste de la page de journalisation est de la configuration : les niveaux de journal, les formats du fichier et de la console, et l’expurgation des secrets dans les lignes de journal, le tout sous le bloc de journalisation que décrit Le fichier de configuration d’OpenClaw.

Sur Diali

Sur Diali, vous n’allez pas chercher un fichier sous un répertoire temporaire : l’activité de l’assistant est dans le tableau de bord, et les journaux propres à la passerelle sont conservés par nous pour l’instance. OpenClaw hébergé sur Diali est l’assistant.

• Un fichier JSON par lignes par jour, tourné à 100 Mo, disparu après 24 heures.
• Suivez-le avec la commande de journaux ou l’interface de contrôle.
• Le docteur d’abord quand la passerelle ne démarre pas.