Intégration (CLI)

CLI onboarding est le chemin de configuration terminal recommandé pour OpenClaw sur macOS, Linux ou Windows. Les utilisateurs du bureau Windows peuvent aussi commencer avec Windows Hub. Il configure un Gateway local ou une connexion à un Gateway distant, ainsi que les canaux, les Skills et les valeurs par défaut de l’espace de travail dans un seul flux guidé.

openclaw onboard

QuickStart ne prend généralement que quelques minutes, mais l’onboarding complet peut prendre plus de temps lorsque la connexion au fournisseur, l’appairage des canaux, l’installation du daemon, les téléchargements réseau, les Skills ou les plugins optionnels nécessitent une configuration supplémentaire. L’assistant affiche cette chronologie dès le départ, et les étapes optionnelles peuvent être ignorées puis reprises plus tard avec openclaw configure.

Paramètres régionaux

L’assistant CLI localise le texte fixe de l’onboarding. Il détermine les paramètres régionaux à partir de OPENCLAW_LOCALE, puis LC_ALL, puis LC_MESSAGES, puis LANG, et se rabat sur l’anglais. Les paramètres régionaux pris en charge par l’assistant sont en, zh-CN et zh-TW.

OPENCLAW_LOCALE=zh-CN openclaw onboard

Les noms et identifiants stables restent littéraux : OpenClaw, Gateway, Tailscale, les commandes, les clés de configuration, les URL, les ID de fournisseurs, les ID de modèles et les libellés de plugins/canaux ne sont pas traduits.

Pour reconfigurer plus tard :

openclaw configureopenclaw agents add <name>

QuickStart ou Avancé

L’onboarding commence par QuickStart (valeurs par défaut) ou Avancé (contrôle complet).

Ce que l’onboarding configure

Le mode local (par défaut) vous guide à travers ces étapes :

1. Modèle/Auth — choisissez n’importe quel fournisseur/flux d’authentification pris en charge (clé d’API, OAuth ou authentification manuelle propre au fournisseur), y compris Custom Provider (compatible OpenAI, compatible Anthropic ou détection automatique Unknown). Choisissez un modèle par défaut. Note de sécurité : si cet agent exécutera des outils ou traitera du contenu Webhook/hooks, préférez le modèle de dernière génération le plus puissant disponible et gardez une politique d’outils stricte. Les niveaux plus faibles/anciens sont plus faciles à injecter par prompt. Pour les exécutions non interactives, --secret-input-mode ref stocke des références adossées à l’environnement dans les profils d’authentification au lieu de valeurs de clé d’API en clair. En mode non interactif ref, la variable d’environnement du fournisseur doit être définie ; passer des indicateurs de clé en ligne sans cette variable d’environnement échoue immédiatement. Dans les exécutions interactives, choisir le mode de référence secrète vous permet de pointer soit vers une variable d’environnement, soit vers une référence de fournisseur configurée (file ou exec), avec une validation préalable rapide avant l’enregistrement. Pour Anthropic, l’onboarding/configuration interactif propose Anthropic Claude CLI comme chemin local préféré et clé d’API Anthropic comme chemin de production recommandé. Anthropic setup-token reste également disponible comme chemin d’authentification par jeton pris en charge.
2. Espace de travail — emplacement des fichiers de l’agent (par défaut ~/.openclaw/workspace). Initialise les fichiers de démarrage.
3. Gateway — port, adresse de liaison, mode d’authentification, exposition Tailscale. En mode token interactif, choisissez le stockage du token en clair par défaut ou optez pour SecretRef. Chemin SecretRef de token non interactif : --gateway-token-ref-env <ENV_VAR>.
4. Canaux — canaux de chat intégrés et plugins officiels tels que iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, QQ Bot, Signal, Slack, Telegram, WhatsApp, et plus encore.
5. Daemon — installe un LaunchAgent (macOS), une unité utilisateur systemd (Linux/WSL2) ou une tâche planifiée Windows native avec solution de repli par dossier de démarrage propre à l’utilisateur. Si l’authentification par token exige un token et que gateway.auth.token est géré par SecretRef, l’installation du daemon le valide mais ne persiste pas le token résolu dans les métadonnées d’environnement du service superviseur. Si l’authentification par token exige un token et que la SecretRef de token configurée n’est pas résolue, l’installation du daemon est bloquée avec des instructions exploitables. Si gateway.auth.token et gateway.auth.password sont tous deux configurés et que gateway.auth.mode n’est pas défini, l’installation du daemon est bloquée jusqu’à ce que le mode soit défini explicitement.
6. Vérification de santé — démarre le Gateway et vérifie qu’il fonctionne.
7. Skills — installe les Skills recommandées et les dépendances optionnelles.

Le mode distant configure uniquement le client local pour se connecter à un Gateway ailleurs. Il n’installe ni ne modifie rien sur l’hôte distant.

Ajouter un autre agent

Utilisez openclaw agents add <name> pour créer un agent séparé avec son propre espace de travail, ses sessions et ses profils d’authentification. L’exécution sans --workspace lance l’onboarding.

Ce qu’il définit :

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir

Notes :

• Les espaces de travail par défaut suivent ~/.openclaw/workspace-<agentId>.
• Ajoutez bindings pour router les messages entrants (l’onboarding peut le faire).
• Indicateurs non interactifs : --model, --agent-dir, --bind, --non-interactive.

Référence complète

Pour des explications détaillées étape par étape et les sorties de configuration, consultez Référence de configuration CLI. Pour des exemples non interactifs, consultez Automatisation CLI. Pour la référence technique plus approfondie, y compris les détails RPC, consultez Référence d’onboarding.

Documentation associée

• Référence des commandes CLI : openclaw onboard
• Vue d’ensemble de l’onboarding : Vue d’ensemble de l’onboarding
• Onboarding de l’application macOS : Onboarding
• Rituel de premier démarrage de l’agent : Démarrage de l’agent