Premiers pas

Objectif : partir de zéro et obtenir un premier chat fonctionnel avec un minimum de configuration.

Info : Le chemin le plus rapide : ouvrez le Control UI (aucune configuration de canal nécessaire). Lancez openclaw dashboard et discutez directement dans le navigateur, ou ouvrez http://127.0.0.1:18789/ sur l’hôte du Gateway (la machine qui exécute le service OpenClaw Gateway). Documentation : Dashboard et Control UI.

Prérequis

Node 24 recommandé (Node 22 LTS, actuellement 22.16+, reste supporté pour la compatibilité)

Astuce : Vérifiez votre version de Node avec node --version en cas de doute.

Installation rapide (CLI)

Étape 1 : Installer OpenClaw (recommandé)

  #### macOS/Linux
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
    <img

src=“https://cdn.openclaws.io/public/docs/assets/install-script.svg” alt=“Install Script Process” class=“rounded-lg” />

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



> **Remarque :** Autres méthodes d'installation et prérequis : [Install](/docs/install).

Étape 2 : Lancer l’assistant de configuration

```bash
openclaw onboard --install-daemon
```

L'assistant configure l'authentification, les paramètres du Gateway et les canaux optionnels.
Voir [Assistant de configuration](/docs/start/wizard) pour les détails.

Étape 3 : Vérifier le Gateway

Si vous avez installé le service, il devrait déjà tourner :

```bash
openclaw gateway status
```

Étape 4 : Ouvrir le Control UI

```bash
openclaw dashboard
```

Vérification : Si le Control UI se charge, votre Gateway est opérationnel.

Vérifications et options supplémentaires

Lancer le Gateway en avant-plan

Utile pour des tests rapides ou du dépannage.

```bash
openclaw gateway --port 18789
```

Envoyer un message de test

Nécessite un canal configuré.

```bash
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
```

Variables d’environnement utiles

Si vous exécutez OpenClaw sous un compte de service ou souhaitez personnaliser l’emplacement de la configuration et des données :

OPENCLAW_HOME définit le répertoire de base utilisé pour la résolution des chemins internes.
OPENCLAW_STATE_DIR remplace le répertoire d’état.
OPENCLAW_CONFIG_PATH remplace le chemin du fichier de configuration.

Référence complète des variables d’environnement : Environment vars.

Pour aller plus loin

Assistant de configuration (détails) — Référence complète de l’assistant CLI et options avancées.
Onboarding de l’application macOS — Première exécution de l’application macOS.

Ce que vous obtiendrez

Un Gateway fonctionnel
L’authentification configurée
L’accès au Control UI ou un canal connecté

Étapes suivantes

Sécurité des DM et approbations : Pairing
Connecter d’autres canaux : Channels
Workflows avancés et installation depuis les sources : Setup