Le fichier de configuration d’OpenClaw

OpenClaw lit un fichier de configuration JSON5 facultatif dans le répertoire OpenClaw sous votre dossier personnel, et si le fichier manque, il tourne sur des valeurs sûres. Chaque réglage de canal, de modèle, d’outil, de bac à sable et d’automatisation finit dans ce fichier, ce qui explique que la documentation consacre plus de mots à la façon dont il est validé et rechargé qu’à n’importe quelle clé. Voici où il vit, les quatre façons de le modifier, la règle qui décide où va un réglage, ce qui se passe quand il est faux, et ce que le rechargement à chaud fait d’un changement.

Quatre façons de le modifier

• Les assistants : le flux de démarrage pour une première configuration et la commande de configuration pour une section à la fois.
• Les commandes d’une ligne : config get, set et unset avec un chemin pointé, qui est aussi la forme que la documentation utilise dans chaque recette.
• L’onglet Config de l’interface de contrôle, un formulaire rendu à partir du schéma en direct avec titres et descriptions, les champs courants d’abord et les champs avancés de chaque section repliés, avec un éditeur JSON brut comme issue de secours.
• Une modification directe : la passerelle surveille le fichier et applique les changements, en traitant une modification manuelle comme non fiable tant qu’elle n’est pas validée. Le chemin doit être un fichier ordinaire ; OpenClaw le remplace de façon atomique, si bien qu’une configuration en lien symbolique voit sa cible remplacée, et un fichier gardé ailleurs est désigné par une variable d’environnement.

La règle des deux compartiments

Les sections de premier niveau contiennent l’infrastructure et les valeurs par défaut communes aux agents : la passerelle, les canaux, les outils, les extensions, les sessions, les médias. La section des valeurs par défaut des agents contient le comportement de la boucle d’agent : espace de travail, modèle, battement de cœur, mémoire. Les entrées par agent peuvent surcharger l’un ou l’autre là où le schéma le permet. La configuration minimale que montre la documentation tient en deux lignes, un espace de travail et une liste d’expéditeurs autorisés pour WhatsApp, et la documentation dit aux agents et aux outils de consulter le schéma d’un champ avant de le modifier.

OpenClaw n’accepte que les configurations qui correspondent entièrement au schéma.

Validation stricte

• Des clés inconnues, des types mal formés ou des valeurs invalides font refuser le démarrage à la passerelle ; le seul extra toléré est un pointeur de schéma à la racine. Le démarrage applique d’abord des migrations sûres des clés héritées, les mêmes transformations sans invite que le docteur, et garde le fichier précédent dans un anneau de sauvegardes.
• Avec un fichier invalide, seules les commandes de diagnostic fonctionnent : docteur, journaux, santé et état. Le docteur montre les problèmes exacts, et son option de réparation applique les corrections.
• La passerelle garde une copie de confiance du dernier état valide après chaque démarrage réussi mais ne la restaure jamais d’elle-même ; elle bloque aussi les écritures qui ressemblent à un écrasement accidentel, comme retirer le mode de passerelle ou réduire le fichier de plus de moitié, et tente d’enregistrer la charge rejetée à côté du fichier pour inspection.

Les commandes de terminal d’OpenClaw liste les commandes qui comptent ici, le docteur en premier, et OpenClaw ne répond pas est l’endroit où une configuration invalide se manifeste comme symptôme : une passerelle qui n’est tout simplement pas là.

Le rechargement à chaud, et où vivent les clés

Le rechargement a deux modes : hybride, par défaut, applique les réglages rechargeables à chaud et redémarre la passerelle automatiquement quand un changement l’exige ; désactivé continue de surveiller et de valider mais attend un redémarrage manuel. Chaque chemin modifié est classé en redémarrage, à chaud ou sans action, le plus long préfixe correspondant décide, et un chemin qui ne correspond à aucune règle vaut redémarrage par défaut. Un rechargement invalide est ignoré et l’exécution garde la dernière configuration acceptée. Les secrets ont leurs propres règles :

• OpenClaw lit les variables d’environnement du processus parent, d’un fichier dot-env dans le répertoire courant et d’un fichier global dans le répertoire OpenClaw ; aucun des deux fichiers n’écrase ce qui est déjà défini.
• Toute valeur texte peut référencer une variable en majuscules avec la syntaxe dollar-accolade ; une variable manquante reste visiblement non résolue avec un avertissement plutôt que de devenir une chaîne vide.
• Les champs qui acceptent une référence de secret peuvent pointer vers une variable d’environnement, un fichier, une commande ou un coffre au lieu de contenir la valeur.

Sur Diali

Sur Diali, le fichier est généré pour chaque assistant à partir de ce que vous réglez dans le tableau de bord, validé avant d’être écrit et remplacé à chaque release, si bien qu’il n’y a rien à modifier à la main et aucun moyen pour une mise à niveau de le laisser invalide. OpenClaw hébergé sur Diali est l’assistant.

• Un fichier JSON5, des valeurs sûres sans lui, un schéma strict avec lui.
• L’infrastructure à la racine, le comportement de l’agent sous les valeurs par défaut.
• Le rechargement hybride redémarre quand il le faut ; le docteur répare quand il ne le peut pas.