Skip to main content

​
openclaw configure

Invites interactives pour apporter des modifications ciblées à une configuration existante : identifiants, appareils, valeurs par défaut des agents, Gateway, canaux, plugins, Skills et contrôles d’intégrité. Utilisez openclaw onboard ou openclaw setup pour suivre l’intégralité du parcours guidé de première exécution, openclaw setup --baseline pour créer uniquement la configuration et l’espace de travail de référence, et openclaw channels add lorsque vous devez seulement configurer un compte de canal.
openclaw config sans sous-commande ouvre le même assistant. Utilisez openclaw config get|set|unset pour effectuer des modifications non interactives.

​
Options

--section <section> : filtre de section répétable. Sections disponibles : workspace, model, web, gateway, daemon, channels, plugins, skills, health
La sélection de gateway, daemon ou health (ou l’exécution de l’assistant complet sans --section) demande où s’exécute le Gateway et met à jour gateway.mode. Les filtres de section qui ignorent ces trois sections accèdent directement à la configuration demandée sans demander le mode du Gateway. Le choix du mode Gateway distant écrit la configuration distante et quitte immédiatement ; il n’exécute pas les étapes réservées à l’environnement local, telles que l’installation de plugins.
openclaw configure nécessite un terminal interactif (stdin et stdout doivent tous deux être des TTY). Sans terminal interactif, la commande affiche les commandes non interactives équivalentes openclaw config get|set|patch|validate et se termine avec une erreur au lieu de s’exécuter partiellement.

​
Section des modèles

Modèle comprend une sélection multiple pour la liste d’autorisation agents.defaults.models (ce qui apparaît dans /model et dans le sélecteur de modèles). Les choix de configuration propres à un fournisseur fusionnent les modèles sélectionnés avec la liste d’autorisation existante au lieu de remplacer les fournisseurs sans rapport déjà présents dans la configuration.La réexécution de l’authentification d’un fournisseur depuis la configuration conserve la valeur existante de agents.defaults.model.primary, même lorsque l’étape d’authentification du fournisseur renvoie un correctif de configuration contenant son propre modèle par défaut recommandé. L’ajout ou la réauthentification d’un fournisseur rend ses modèles disponibles sans remplacer votre modèle principal actuel. Utilisez openclaw models auth login --provider <id> --set-default ou openclaw models set <model> pour modifier intentionnellement le modèle par défaut.
Lorsque la configuration démarre depuis un choix d’authentification de fournisseur, les sélecteurs du modèle par défaut et de la liste d’autorisation privilégient automatiquement ce fournisseur. Pour les fournisseurs associés tels que Volcengine et BytePlus, cette préférence correspond également à leurs variantes de forfait de programmation (volcengine-plan/*, byteplus-plan/*). Si le filtre du fournisseur privilégié produisait une liste vide, la configuration revient au catalogue non filtré au lieu d’afficher un sélecteur vide.

​
Section Web

openclaw configure --section web permet de choisir un fournisseur de recherche sur le Web et de configurer ses identifiants. Certains fournisseurs affichent des étapes supplémentaires qui leur sont propres :
  • Grok peut proposer une configuration facultative de x_search avec le même profil OAuth xAI ou la même clé API, et vous permettre de choisir un modèle x_search.
  • Kimi peut demander la région de l’API Moonshot (api.moonshot.ai ou api.moonshot.cn) et le modèle Kimi de recherche sur le Web par défaut.

​
Autres remarques

  • Après l’écriture de la configuration locale, la commande de configuration installe les plugins téléchargeables sélectionnés lorsque le parcours de configuration choisi les exige. La configuration d’un Gateway distant n’installe pas de paquets de plugins locaux.
  • Les services axés sur les canaux (Slack/Discord/Matrix/Microsoft Teams) demandent des listes d’autorisation de canaux ou de salons pendant la configuration. Vous pouvez saisir des noms ou des identifiants ; l’assistant résout les noms en identifiants lorsque cela est possible.
  • Si vous exécutez l’étape d’installation du démon, l’authentification par jeton nécessite un jeton. Si gateway.auth.token est géré par SecretRef, la configuration valide la SecretRef, mais ne conserve pas les valeurs résolues du jeton en texte brut dans les métadonnées d’environnement du service superviseur ; si la SecretRef n’est pas résolue, la configuration bloque l’installation du démon et fournit des instructions de correction directement applicables.
  • Si gateway.auth.token et gateway.auth.password sont tous deux configurés alors que gateway.auth.mode n’est pas défini, la configuration bloque l’installation du démon jusqu’à ce que vous définissiez explicitement le mode.

​
Voir aussi