OpenClaw reçoit un guide complet en russe sur la configuration JSON5, le CLI et la configuration sécurisée

Un guide détaillé sur OpenClaw a été publié sur Habr — une plateforme où la quasi-totalité de la configuration opérationnelle repose sur un seul fichier, openclaw.json, et un vaste CLI. Le document rassemble en un seul endroit ce qu'il fallait auparavant dénicher dans la documentation officielle, les GitHub issues et les publications de la communauté.

Ce que contient la configuration

L'auteur explique comment le niveau supérieur de la configuration est structuré et pourquoi OpenClaw exige de la précision lors de l'édition manuelle. Le fichier utilise JSON5, ce qui autorise les commentaires et les virgules finales, mais le schéma est vérifié très strictement au démarrage. Si une clé inconnue est ajoutée, la passerelle ne démarre tout simplement pas.

Les sections suivantes sont décrites séparément : gateway, env, agents, models, auth, channels, session, cron, tools, sandbox et logging, ainsi que le fonctionnement du hot reload sans redémarrage complet.

• gateway : port, mode bind, jeton d'accès et comportement du hot reload
• agents et models : paramètres de base, fallbacks et sélection de fournisseurs
• auth et channels : changement de profils, Telegram, Discord et autres canaux
• session et cron : isolation des dialogues, réinitialisations programmées et tâches en arrière-plan
• env et secrets : priorité des variables, SecretRef et stockage des données sensibles

La principale valeur du document réside dans le fait qu'il ne se limite pas à une liste de champs. Le texte explique comment les différents niveaux de configuration s'articulent, où s'appliquent les valeurs par défaut, quand les paramètres prennent effet sans redémarrage et quels paramètres il vaut mieux ne pas modifier manuellement.

Pour ceux qui font tourner OpenClaw non pas en local, mais sur un VPS ou dans un environnement de travail, ce n'est plus une simple référence, mais un operational playbook à part entière.

Où la configuration se casse

La section la plus utile est consacrée non pas au happy path, mais aux pannes typiques. Le guide souligne que certains paramètres ne fonctionnent que dans agents.defaults et sont ignorés silencieusement s'ils sont déplacés vers la configuration d'un agent spécifique. De ce fait, la configuration peut sembler correcte sans que le comportement souhaité ne s'active.

La recommandation est simple : utiliser plus souvent les commandes openclaw config get, set et unset plutôt que d'éditer directement, et lancer un diagnostic après chaque modification.

openclaw doctor — la commande la plus utile de tout le CLI.

La question du gonflement du contexte est également abordée. OpenClaw utilise deux mécanismes distincts : pruning supprime les anciens résultats d'outils avant d'appeler le modèle, tandis que compaction compresse l'historique lorsque la fenêtre de contexte est presque pleine. En guise d'exemple, un cas est cité où 35 messages ont abouti à un fichier de session de 2,9 Mo et un contexte de 208 467 tokens, empêchant le système de répondre avec une limite de modèle de 200 000 tokens.

CLI pour les administrateurs

Le CLI est organisé non par ordre alphabétique, mais par scénarios de travail, ce qui rend le guide pratique. Les commandes pour démarrer la passerelle, vérifier l'état du daemon, gérer les canaux, les logs, les tâches cron, les plugins, les skills, les sessions et les mises à jour sont toutes rassemblées en un seul endroit.

Pour les commandes d'infrastructure, les modes sécurisés sont mis en avant séparément : health fonctionne même sans daemon actif, security audit vérifie la configuration pour détecter les risques, et secrets audit permet de repérer les fuites de credentials avant la mise en production.

Le dernier bloc important porte sur les variables d'environnement et le contrôle de version. Le guide documente l'ordre de priorité : d'abord l'environnement du processus, puis le .env local, ensuite le .env global dans le répertoire OpenClaw, et enfin les env.vars intégrées. Pour les secrets, il est recommandé d'utiliser des références à des variables ou SecretRef plutôt que des valeurs directement dans openclaw.json, et de ne committer dans le dépôt qu'un template de configuration, en excluant les fichiers .env, les dossiers de session, les fichiers de mémoire et l'état temporaire.

Ce que cela signifie

OpenClaw devient un outil non seulement pour les enthousiastes prêts à lire le code source, mais aussi pour les équipes qui ont besoin d'un operational playbook clair. Si un projet repose sur plusieurs modèles, canaux et automatisations, un tel guide réduit le risque de pannes silencieuses, de fuites de secrets et de comportement instable après les mises à jour.