Skip to main content
L’intégration via la CLI est la méthode de configuration recommandée dans le terminal sous macOS, Linux et Windows (natif ou WSL2). Par défaut, elle détecte l’accès à l’IA déjà disponible sur la machine, le vérifie au moyen d’une complétion réelle, puis démarre OpenClaw afin de configurer l’espace de travail, le Gateway et les fonctionnalités facultatives. openclaw setup exécute le même processus (Configuration décrit la variante de configuration uniquement --baseline). Les utilisateurs de l’application de bureau Windows peuvent également commencer depuis Windows Hub. L’intégration guidée commence par établir l’inférence. Elle détecte les accès à l’IA disponibles, exige une complétion réelle, puis démarre seulement ensuite OpenClaw afin de configurer le reste d’OpenClaw. Choisir Skip for now quitte l’intégration sans démarrer OpenClaw. L’assistant classique reste disponible pour les fournisseurs personnalisés, la configuration d’un Gateway distant, l’association des canaux, les contrôles du daemon, les Skills et les importations. Exécutez-le explicitement avec openclaw onboard --classic ; le sélecteur d’inférence guidé ne lui délègue pas le processus. Une fois l’inférence validée, OpenClaw peut utiliser open channel wizard for <channel> pour confier la configuration des canaux nécessitant des secrets à un assistant de terminal qui masque les saisies. Pour changer le fournisseur du modèle ou son authentification, quittez OpenClaw et exécutez openclaw onboard ; OpenClaw n’ouvre pas les processus guidés ou classiques relatifs aux fournisseurs.
Pour démarrer une première conversation au plus vite : terminez la configuration guidée, exécutez openclaw dashboard, puis discutez dans le navigateur via l’interface de contrôle. Documentation : Tableau de bord.

​
Paramètres régionaux

L’assistant localise les textes fixes de l’intégration. Ordre de résolution : OPENCLAW_LOCALE, LC_ALL, LC_MESSAGES, LANG, puis l’anglais. Paramètres régionaux pris en charge : en, zh-CN, zh-TW.
Les noms de produits, commandes, clés de configuration, URL, identifiants de fournisseurs, identifiants de modèles et libellés de plugins/canaux restent en anglais, quels que soient les paramètres régionaux. Pour reconfigurer ultérieurement les paramètres sans rapport avec l’inférence :
--json n’implique pas le mode non interactif. Pour les scripts, utilisez --non-interactive (voir Automatisation de la CLI).
L’assistant classique comprend une étape de recherche sur le Web permettant de choisir un fournisseur : Brave, DuckDuckGo, Exa, Firecrawl, Gemini, Grok, Kimi, MiniMax Search, Ollama Web Search, Perplexity, SearXNG ou Tavily. Certains nécessitent une clé API ; d’autres n’en nécessitent aucune. Configurez cela ultérieurement avec openclaw configure --section web. Documentation : Outils Web.

​
Parcours guidé par défaut

La commande simple openclaw onboard suit ce parcours :
  1. Acceptez l’avis de sécurité.
  2. Détectez les modèles configurés, les variables d’environnement contenant des clés API, les CLI d’IA locales prises en charge et les modèles déjà installés capables d’utiliser des outils sur les serveurs Ollama ou LM Studio accessibles depuis l’hôte du Gateway. Cette analyse en lecture seule ne télécharge jamais de modèle. Les installations de Gemini CLI et d’Antigravity sont signalées, mais ne sont pas testées automatiquement, car elles ne permettent pas d’imposer un test sans outil.
  3. Testez le premier candidat détecté au moyen d’une complétion réelle. En cas d’échec, affichez-en la raison et passez au candidat utilisable suivant.
  4. Si la détection ne trouve plus aucun candidat, choisissez OpenAI, Anthropic, xAI (Grok), Google ou OpenRouter, ou choisissez More… pour accéder aux autres fournisseurs. Les régions, offres et méthodes prises en charge par chaque fournisseur — navigateur, appareil, clé API ou jeton — apparaissent dans un second menu et sont testées au moyen de la même complétion réelle. Choisissez Skip for now pour quitter sans démarrer OpenClaw.
  5. Conservez uniquement la route du modèle vérifiée ainsi que tout état d’identifiants ou de Plugin qu’elle requiert. Les paramètres de l’espace de travail et du Gateway restent inchangés.
  6. Démarrez OpenClaw avec le modèle vérifié afin qu’il puisse configurer l’espace de travail, le Gateway, les canaux, les agents, les plugins et les autres éléments facultatifs de la configuration.
La réexécution de la commande sur une installation configurée teste d’abord le modèle actuellement défini par défaut, ce qui transforme le processus guidé en une procédure de vérification et de réparation. Un échec de vérification ne remplace jamais automatiquement le modèle configuré ; l’intégration s’interrompt et demande comment continuer. Exécutez openclaw channels add ou openclaw configure pour ajouter ultérieurement des éléments sans rapport avec l’inférence ; utilisez openclaw onboard pour modifier le fournisseur ou la route d’authentification.

​
Assistant classique : QuickStart ou Advanced

Exécutez openclaw onboard --classic pour ouvrir l’assistant complet. Il commence par proposer QuickStart (valeurs par défaut) ou Advanced (contrôle total). Transmettez --flow quickstart ou --flow advanced (alias manual) pour sélectionner le processus classique et ignorer cette invite.
  • Gateway local, liaison à l’interface de bouclage
  • Espace de travail par défaut (ou espace de travail existant)
  • Port du Gateway : 18789
  • Authentification du Gateway : Token (généré automatiquement, même sur l’interface de bouclage)
  • Politique des outils : tools.profile: "coding" pour les nouvelles configurations (un profil explicite existant est conservé)
  • Isolation des messages privés : session.dmScope: "per-channel-peer" pour les nouvelles configurations. Détails : Référence de configuration de la CLI
  • Exposition via Tailscale : Off
  • Les messages privés Telegram et WhatsApp utilisent par défaut une liste d’autorisation : Telegram demande un identifiant numérique d’utilisateur Telegram, tandis que WhatsApp demande un numéro de téléphone
Le mode distant (--mode remote) utilise toujours le processus avancé ; il se contente de configurer cette machine pour qu’elle se connecte à un Gateway situé ailleurs et n’installe ni ne modifie jamais quoi que ce soit sur l’hôte distant.

​
Éléments configurés par l’intégration classique

Le mode local (par défaut) parcourt les étapes suivantes :
  1. Modèle/Authentification - choisissez un processus d’authentification du fournisseur (clé API, OAuth ou authentification manuelle propre au fournisseur), y compris Fournisseur personnalisé (compatible avec OpenAI, compatible avec OpenAI Responses, compatible avec Anthropic ou détection automatique inconnue). Choisissez un modèle par défaut. Une nouvelle configuration par clé API OpenAI utilise par défaut openai/gpt-5.6 (l’identifiant brut de l’API directe est résolu vers Sol) ; une nouvelle configuration ChatGPT/Codex utilise par défaut openai/gpt-5.6-sol. La réexécution de la configuration conserve tout modèle explicite existant, y compris openai/gpt-5.5. Sélectionnez explicitement openai/gpt-5.5 si le compte ne donne pas accès à GPT-5.6. Remarque de sécurité : si cet agent doit exécuter des outils ou traiter le contenu de webhooks/hooks, privilégiez le modèle de dernière génération le plus puissant disponible et maintenez une politique stricte pour les outils ; les niveaux moins puissants ou plus anciens sont plus vulnérables aux injections de prompt. Pour les exécutions non interactives, --secret-input-mode ref stocke des références reposant sur l’environnement plutôt que des valeurs de clés API en texte brut ; la variable d’environnement référencée doit déjà être définie, faute de quoi l’intégration échoue immédiatement. En mode interactif, la référence du secret peut pointer vers une variable d’environnement ou une référence de fournisseur configurée (file ou exec), avec une vérification préalable rapide avant l’enregistrement. Après la configuration du modèle et de l’authentification, l’assistant propose un test facultatif de complétion en direct ; en cas d’échec, il est possible de revenir une fois à la configuration du modèle et de l’authentification ou d’ignorer l’échec sans bloquer le reste de l’assistant classique. L’ignorer ne déverrouille pas OpenClaw ; la configuration conversationnelle exige toujours une vérification d’inférence réussie.
  2. Espace de travail - répertoire des fichiers de l’agent (par défaut ~/.openclaw/workspace). Crée les fichiers d’amorçage.
  3. Gateway - port, adresse de liaison, mode d’authentification, exposition via Tailscale. En mode interactif avec jeton, choisissez le stockage du jeton en texte brut (par défaut) ou optez pour une SecretRef. Chemin non interactif de la SecretRef : --gateway-token-ref-env <ENV_VAR>.
  4. Canaux - canaux de discussion intégrés et fournis par des plugins officiels, notamment Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp et bien d’autres.
  5. Daemon - installe un LaunchAgent (macOS), une unité utilisateur systemd (Linux/WSL2) ou une tâche planifiée Windows native, avec un mécanisme de secours par utilisateur dans le dossier Startup. Si l’authentification par jeton est requise et que gateway.auth.token est géré par une SecretRef, l’installation du daemon la valide, mais ne conserve aucun jeton résolu dans les métadonnées d’environnement du service de supervision ; une SecretRef non résolue bloque l’installation et fournit des instructions. Si gateway.auth.token et gateway.auth.password sont tous deux définis alors que gateway.auth.mode ne l’est pas, l’installation est bloquée jusqu’à ce que le mode soit défini explicitement.
  6. Vérification de l’état - démarre le Gateway et vérifie qu’il est accessible.
  7. Skills - installe les Skills recommandés et leurs dépendances facultatives.
La réexécution de l’intégration n’efface rien, sauf si vous choisissez explicitement Reset (ou transmettez --reset). La commande CLI --reset cible par défaut la configuration, les identifiants et les sessions ; utilisez --reset-scope full pour supprimer également l’espace de travail. Si la configuration n’est pas valide ou contient des clés héritées, l’intégration vous demande d’abord d’exécuter openclaw doctor.
--flow import exécute dans l’assistant classique un processus de migration détecté (par exemple Hermes) au lieu d’une nouvelle configuration ; consultez Migrer et les guides de migration sous Installation. openclaw onboard --modern est un alias de compatibilité pour OpenClaw. Il utilise la même barrière d’inférence que openclaw setup : une inférence vérifiée démarre l’assistant, tandis qu’un échec interactif renvoie à la configuration guidée de l’inférence.

​
Ajouter un autre agent

Utilisez openclaw agents add <name> pour créer un agent distinct disposant de ses propres espace de travail, sessions et profils d’authentification. Une exécution sans --workspace démarre un processus interactif pour le nom, l’espace de travail, l’authentification, les canaux et les liaisons ; il ne s’agit pas de l’assistant openclaw onboard complet. Éléments définis :
  • agents.list[].name
  • agents.list[].workspace
  • agents.list[].agentDir
Remarques :
  • Espace de travail par défaut : ~/.openclaw/workspace-<agentId> (ou sous agents.defaults.workspace si cette valeur est définie).
  • Ajoutez bindings pour acheminer les messages entrants vers cet agent (l’intégration peut le faire pour vous).
  • Options non interactives : --model, --agent-dir, --bind, --non-interactive.

​
Référence complète

Pour connaître en détail le comportement étape par étape et les configurations produites, consultez la Référence de configuration de la CLI. Pour des exemples non interactifs, consultez Automatisation de la CLI. Pour la référence complète des options, consultez openclaw onboard.

​
Documentation associée