--- read_when: - Vous effectuez la configuration initiale avec l’assistant d’intégration de la CLI - Vous souhaitez définir le chemin d’accès par défaut de l’espace de travail - Vous avez besoin de l’option de configuration réservée à la référence pour les scripts summary: Référence de la CLI pour `openclaw setup` (alias de l’intégration, avec configuration de base disponible via une option) title: Configuration x-i18n: generated_at: "2026-07-12T02:27:55Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: fe3c631a2ed7328ab7e7d1438adff2d6112514b3fdcfb82923ba6ea04650c385 source_path: cli/setup.md workflow: 16 --- # `openclaw setup` `openclaw setup` exécute le même parcours guidé de prise en main que `openclaw onboard` : il vérifie et enregistre d’abord l’inférence, puis lance Crestodian pour configurer l’espace de travail, le Gateway, les canaux, les Skills et l’état de santé. Utilisez `--baseline` lorsque vous souhaitez uniquement initialiser les dossiers de configuration et de l’espace de travail sans l’assistant. En mode guidé, `--workspace ` correspond à l’espace de travail proposé à Crestodian ; il n’est enregistré qu’après votre approbation de cette proposition. Les configurations de base, classique et non interactive enregistrent l’espace de travail fourni selon leur parcours normal. `setup` accepte les mêmes options de prise en main que `openclaw onboard`, notamment pour l’authentification (`--auth-choice`, `--token`, options de clé de fournisseur), le Gateway (`--gateway-port`, `--gateway-bind`, `--gateway-auth`, `--install-daemon`), Tailscale (`--tailscale`), la réinitialisation (`--reset`, `--reset-scope`), le parcours (`--flow quickstart|advanced|manual|import`) et les options d’omission (`--skip-channels`, `--skip-skills`, `--skip-bootstrap`, `--skip-search`, `--skip-health`, `--skip-ui`, `--skip-hooks`). Consultez [Prise en main](/fr/cli/onboard) et [Automatisation de la CLI](/fr/start/wizard-cli-automation) pour obtenir la liste complète des options et des exemples non interactifs. `openclaw onboard --modern` est l’alias de compatibilité de l’assistant Crestodian soumis à la validation de l’inférence et n’a pas d’équivalent pour `setup`. `openclaw setup` est destiné aux installations dont la configuration est modifiable. En mode Nix (`OPENCLAW_NIX_MODE=1`), OpenClaw refuse les écritures de configuration, car le fichier de configuration est géré par Nix. Utilisez le [Démarrage rapide de nix-openclaw](https://github.com/openclaw/nix-openclaw#quick-start) officiel ou la configuration source équivalente pour un autre paquet Nix. ## Options | Option | Description | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | `--workspace ` | Proposition d’espace de travail en mode guidé ; enregistrée directement par les configurations de base, classique et non interactive. | | `--baseline` | Crée les dossiers de configuration, d’espace de travail et de session de base sans prise en main. | | `--wizard` | Acceptée à des fins de compatibilité ; la configuration exécute la prise en main par défaut. | | `--non-interactive` | Exécute la prise en main sans invite. | | `--accept-risk` | Confirme la prise en compte du risque lié à l’accès de l’agent à l’ensemble du système ; requise avec `--non-interactive`. | | `--mode ` | Mode de prise en main : `local` ou `remote`. | | `--flow ` | Parcours de prise en main : `quickstart`, `advanced`, `manual` ou `import`. | | `--reset` | Réinitialise la configuration, les identifiants et les sessions avant la prise en main (espace de travail uniquement avec `--reset-scope full`). | | `--reset-scope ` | Périmètre de réinitialisation : `config`, `config+creds+sessions` ou `full`. | | `--import-from ` | Fournisseur de migration à utiliser pendant la prise en main. | | `--import-source ` | Répertoire personnel de l’agent source pour `--import-from`. | | `--import-secrets` | Importe les secrets pris en charge pendant la migration de prise en main. | | `--remote-url ` | URL WebSocket du Gateway distant. | | `--remote-token ` | Jeton du Gateway distant (facultatif). | | `--json` | Produit un résumé JSON. | `--classic` et `--non-interactive` s’excluent mutuellement : le mode classique ouvre l’assistant interactif, tandis que la configuration non interactive utilise le parcours d’automatisation. ### Mode de base `openclaw setup --baseline` conserve l’ancien comportement limité à la configuration de base : il crée les répertoires de configuration, d’espace de travail et de session, puis se termine sans exécuter la prise en main. ## Exemples ```bash openclaw setup openclaw setup --baseline openclaw setup --workspace ~/.openclaw/workspace openclaw setup --import-from hermes --import-source ~/.hermes openclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token ``` ## Remarques - Après la configuration de base, exécutez `openclaw setup` ou `openclaw onboard` pour suivre l’intégralité du parcours guidé, `openclaw configure` pour effectuer des modifications ciblées, ou `openclaw channels add` pour ajouter des comptes de canal. - Si un état Hermes est détecté, la prise en main interactive peut proposer automatiquement une migration. La prise en main avec importation nécessite une nouvelle configuration ; utilisez [Migrer](/fr/cli/migrate) pour obtenir des plans de simulation, des sauvegardes et un mode d’écrasement en dehors de la prise en main. ## Voir aussi - [Référence de la CLI](/fr/cli) - [Prise en main](/fr/cli/onboard) - [Prise en main (CLI)](/fr/start/wizard) - [Bien démarrer](/fr/start/getting-started) - [Vue d’ensemble de l’installation](/fr/install)