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.

Options

--section <section> : filtre de section répétable. Sections disponibles :

workspace, model, web, gateway, daemon, channels, plugins, skills, health

openclaw configureopenclaw configure --section webopenclaw configure --section model --section channelsopenclaw configure --section gateway --section daemon

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.

Section des modèles

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

• Référence de la CLI
• Configuration
• CLI de configuration : Configuration