OpenClaw dispose d'un guide complet en russe sur sa configuration JSON5, sa CLI et son paramétrage sécurisé

Habr a publié un guide détaillé d'OpenClaw, une plateforme dont presque toute la configuration opérationnelle repose sur un seul fichier, openclaw.json, et sur une CLI volumineuse. Le texte rassemble au même endroit ce qu'il fallait auparavant dénicher dans l'aide officielle, les issues GitHub et les publications de la communauté.

Ce que contient la configuration

L'auteur explique comment s'organise le niveau supérieur de la configuration et pourquoi OpenClaw exige de la prudence lors d'une édition manuelle. Le fichier utilise JSON5 : il autorise donc les commentaires et les virgules finales, mais le schéma est validé très strictement au démarrage. Si l'on ajoute une clé inconnue, la passerelle ne démarre tout simplement pas. Le guide décrit séparément gateway, env, agents, models, auth, channels, session, cron, tools, sandbox et logging, ainsi que le fonctionnement du rechargement à chaud sans redémarrage complet.

• gateway : port, mode bind, jeton d'accès et comportement du hot reload
• agents et models : réglages de base, fallbacks et choix des fournisseurs
• auth et channels : changement de profils, Telegram, Discord et autres canaux
• session et cron : isolation des conversations, réinitialisations horaires et tâches de fond
• env et secrets : priorité des variables, SecretRef et stockage des données sensibles

La principale valeur du texte tient à ce qu'il ne se limite pas à une liste de champs. Il explique comment les différents niveaux de configuration s'articulent, où s'appliquent les valeurs par défaut, quand les réglages prennent effet sans redémarrage et quels paramètres mieux vaut ne pas toucher à la main. Pour ceux qui font tourner OpenClaw non pas en local, mais sur un VPS ou en environnement de travail, ce n'est plus une simple référence, c'est un véritable operational playbook.

Où la configuration casse

Le passage le plus utile porte non pas sur le happy path, mais sur les pannes typiques. Le guide souligne que certains paramètres ne fonctionnent que dans agents.defaults et sont ignorés en silence s'ils sont déplacés dans les réglages d'un agent précis. La configuration peut ainsi sembler correcte sans que le comportement voulu s'active. La recommandation est simple : recourir plus souvent aux commandes openclaw config get, set et unset plutôt qu'à l'édition directe, et lancer le diagnostic après chaque modification.

openclaw doctor est la commande la plus utile de toute la CLI.

Le guide traite aussi du problème de gonflement du contexte. OpenClaw utilise deux mécanismes distincts : le pruning supprime les anciens résultats d'outils avant l'appel au modèle, tandis que la compaction compresse l'historique lorsque la fenêtre de contexte est presque pleine. Il cite l'exemple de 35 messages devenus un fichier de session de 2,9 Mo et un contexte de 208 467 tokens, au point que le système a cessé de répondre avec une limite du modèle de 200 000 tokens.

La CLI pour les administrateurs

La CLI est présentée par scénarios de travail et non par ordre alphabétique, ce qui rend le guide pratique. Les commandes pour lancer la passerelle, consulter l'état du démon, gérer les canaux, les logs, les tâches cron, les plugins, les skills, les sessions et les mises à jour sont réunies au même endroit. Pour les commandes d'infrastructure, les modes sûrs sont présentés à part : health fonctionne même sans démon lancé, security audit examine la configuration à la recherche de risques et secrets audit aide à repérer les fuites d'identifiants avant la production.

Le dernier bloc important concerne les variables d'environnement et le contrôle de version. Le guide fixe l'ordre de priorité : d'abord l'environnement du processus, puis le .env local, ensuite le .env global dans le répertoire d'OpenClaw, et seulement après les env.vars intégrées. Pour les secrets, il conseille d'utiliser des références à des variables ou SecretRef plutôt que des valeurs dans openclaw.json, et de ne versionner dans le dépôt qu'un modèle de configuration, en excluant .env, les dossiers de sessions, les fichiers de mémoire et l'état temporaire.

Ce que cela signifie

OpenClaw devient un outil non seulement pour les passionnés 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.