Intégration (CLI)

openclaw onboard

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 les accès à l’IA déjà disponibles sur la machine, les vérifie à l’aide d’une complétion réelle, puis démarre Crestodian 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 --baseline, limitée à la configuration). Les utilisateurs de l’application de bureau Windows peuvent également commencer depuis le Hub Windows.

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 Crestodian pour configurer le reste d’OpenClaw. Le processus guidé ne propose ni Crestodian avant l’inférence, ni option permettant d’ignorer l’IA.

L’assistant classique reste disponible pour la connexion aux fournisseurs, la configuration d’un Gateway distant, l’association des canaux, la gestion du démon, les Skills et les importations. Exécutez-le explicitement avec openclaw onboard --classic ; l’écran guidé des candidats d’inférence ne lui délègue pas le processus. Une fois l’inférence validée, Crestodian peut utiliser open channel wizard for <channel> pour confier à un assistant de terminal masqué la configuration des canaux nécessitant des secrets. Pour changer de fournisseur de modèle ou modifier son authentification, quittez Crestodian et exécutez openclaw onboard ; Crestodian n’ouvre pas les processus guidés ou classiques des fournisseurs.

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.

OPENCLAW_LOCALE=zh-CN openclaw onboard

Les noms de produits, commandes, clés de configuration, URL, identifiants de fournisseurs, identifiants de modèles et libellés de plugins ou de 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 :

openclaw configureopenclaw agents add <name>

Processus guidé par défaut

La commande simple openclaw onboard suit ce processus :

1. Acceptez l’avis de sécurité.
2. Détectez les modèles configurés, les variables d’environnement contenant des clés API et les CLI d’IA locales prises en charge.
3. Testez le premier candidat détecté à l’aide d’une complétion réelle. En cas d’échec, affichez la raison et passez au candidat utilisable suivant.
4. Si la détection ne trouve plus de candidats, réessayez un candidat détecté ou saisissez la clé API d’un fournisseur dans une invite masquée. L’intégration guidée ne propose ni Crestodian ni une sortie permettant d’ignorer l’IA tant que l’inférence ne fonctionne pas.
5. Enregistrez uniquement la route de modèle vérifiée ainsi que les éventuels états d’identifiants ou de plugins qu’elle requiert. Les paramètres de l’espace de travail et du Gateway restent inchangés.
6. Démarrez Crestodian 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.

Lors d’une nouvelle exécution de la commande sur une installation déjà configurée, le modèle par défaut actuel est testé en premier, ce qui transforme le processus guidé en étape de vérification et de réparation. Un échec de vérification ne remplace jamais automatiquement le modèle configuré ; l’intégration s’arrête et demande comment poursuivre. 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 : démarrage rapide ou avancé

Exécutez openclaw onboard --classic pour ouvrir l’assistant complet. Il commence par proposer Démarrage rapide (valeurs par défaut) ou Avancé (contrôle total). Utilisez --flow quickstart ou --flow advanced (alias manual) pour sélectionner le processus classique et ignorer cette invite.

Le mode distant (--mode remote) utilise toujours le processus avancé ; il configure uniquement cette machine pour se connecter à 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) suit 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 un 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 d’API directe sans préfixe est résolu vers Sol) ; une nouvelle configuration ChatGPT/Codex utilise par défaut openai/gpt-5.6-sol. Une nouvelle exécution de la configuration conserve un 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 du contenu provenant de Webhooks ou de hooks, privilégiez le modèle de dernière génération le plus puissant disponible et appliquez une politique stricte aux 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 des variables d’environnement plutôt que les valeurs des clés API en texte brut ; la variable d’environnement référencée doit déjà être définie, sinon l’intégration échoue immédiatement. En mode interactif de référence de secret, il est possible de 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, vous pouvez revenir une fois à la configuration du modèle et de l’authentification ou ignorer l’échec sans bloquer la suite de l’assistant classique. Ignorer l’échec ne déverrouille pas Crestodian ; la configuration conversationnelle nécessite toujours la réussite d’une vérification d’inférence.
2. Espace de travail - répertoire des fichiers de l’agent (~/.openclaw/workspace par défaut). Initialise les fichiers d’amorçage.
3. Gateway - port, adresse de liaison, mode d’authentification et exposition Tailscale. En mode interactif avec jeton, choisissez le stockage du jeton en texte brut (par défaut) ou optez pour une SecretRef. Chemin SecretRef non interactif : --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 d’autres.
5. Démon - installe un LaunchAgent (macOS), une unité utilisateur systemd (Linux/WSL2) ou une tâche planifiée Windows native avec un mécanisme de secours dans le dossier de démarrage propre à l’utilisateur. Si l’authentification par jeton est requise et que gateway.auth.token est géré par SecretRef, l’installation du démon le valide, mais n’enregistre pas le jeton résolu dans les métadonnées d’environnement du service de supervision ; une SecretRef non résolue bloque l’installation et affiche 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 vous définissiez explicitement le mode.
6. Vérification d’intégrité - démarre le Gateway et vérifie qu’il est accessible.
7. Skills - installe les Skills recommandées et leurs dépendances facultatives.

--flow import exécute dans l’assistant classique un processus de migration détecté (par exemple Hermes) à la place d’une nouvelle configuration ; consultez Migrer et les guides de migration sous Installation. openclaw onboard --modern est un alias de compatibilité pour Crestodian. Il utilise la même barrière d’inférence que openclaw crestodian : une inférence vérifiée démarre l’assistant, tandis qu’un échec interactif renvoie vers 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 complet openclaw onboard.

É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 option est définie).
• Ajoutez des 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 obtenir une description détaillée, étape par étape, du comportement et des configurations générées, 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

• Référence des commandes de la CLI : openclaw onboard
• Présentation de l’intégration : Présentation de l’intégration
• Intégration de l’application macOS : Intégration
• Rituel de premier démarrage de l’agent : Amorçage de l’agent