Installation

Installer OpenClaw en partant de zéro, c'est vraiment simple ! Suis les étapes ci-dessous une par une, ça prend environ 5 à 10 minutes. Pas d'inquiétude, on t'explique chaque étape.

📋 Configuration requise

Avant de commencer l'installation, vérifie que ton ordinateur répond à ces conditions :

Node.js 22 ou supérieur — C'est l'environnement de base pour faire tourner OpenClaw (pas de souci, le script d'installation vérifiera pour toi)
Système d'exploitation — macOS, Linux ou Windows (avec WSL2)
Mémoire — Au moins 2 Go de RAM disponible
Espace disque — Au moins 500 Mo d'espace libre
Réseau — Connexion internet nécessaire pour le téléchargement et les appels API

ℹ️ C'est quoi Node.js ? Pour faire simple, Node.js est une sorte de « traducteur » qui permet à ton ordinateur d'exécuter des programmes écrits en JavaScript. OpenClaw est écrit en JavaScript, il a donc besoin de Node.js pour fonctionner. Tu n'as pas besoin d'apprendre JavaScript, juste d'installer Node.js.

ℹ️ C'est quoi WSL2 ? Si tu es sous Windows : OpenClaw ne tourne pas directement sur Windows, il a besoin de WSL2 (Windows Subsystem for Linux 2), qui est comme un mini système Linux installé dans Windows. Si tu es sous Windows, le script d'installation s'en occupera automatiquement.

🌟 Méthode 1 : Script d'installation en une ligne (recommandé pour les débutants !)

C'est la méthode la plus simple. Il te suffit de copier-coller une seule commande dans le terminal, et le script s'occupe de tout. Vraiment facile, suis le guide !

💡 C'est quoi un « terminal » ? Le terminal est une fenêtre où tu peux taper des commandes texte. Sur macOS, il s'appelle « Terminal », sur Windows c'est « PowerShell » ou « Invite de commandes ». Tu peux le trouver en cherchant « Terminal » sur ton ordinateur.

Ouvre le Terminal

Appuie sur Command + Espace, tape « Terminal », puis appuie sur Entrée. Une fenêtre de ligne de commande (noire ou blanche) va s'ouvrir.

Copie-colle la commande d'installation

Copie la ligne suivante, colle-la dans la fenêtre du terminal, puis appuie sur Entrée :

curl -fsSL https://openclaw.ai/install.sh | bash

Cette commande va :

Vérifier si Node.js est installé sur ton ordinateur, et l'installer automatiquement si nécessaire
Télécharger et installer la dernière version d'OpenClaw
Lancer l'assistant de configuration (onboarding) pour te guider dans la mise en place initiale

Attends la fin de l'installation

L'installation prend environ 2 à 5 minutes, selon ta connexion internet. Tu verras du texte défiler dans le terminal, c'est normal, pas de panique ! Une fois terminé, l'assistant de configuration se lancera automatiquement.

Ouvre le Terminal

Sur Linux, tu peux appuyer sur Ctrl + Alt + T pour ouvrir le terminal, ou chercher « Terminal » dans le menu des applications.

Copie-colle la commande d'installation

Comme sur macOS, copie la commande ci-dessous, colle-la dans le terminal et appuie sur Entrée :

curl -fsSL https://openclaw.ai/install.sh | bash

Le script va automatiquement vérifier Node.js, télécharger OpenClaw et lancer l'assistant de configuration.

Attends la fin de l'installation

Patiente quelques minutes. Quand tu vois l'assistant de configuration apparaître, c'est que l'installation a réussi !

Ouvre PowerShell (en tant qu'administrateur)

Dans le menu Démarrer, cherche « PowerShell », fais un clic droit dessus et sélectionne « Exécuter en tant qu'administrateur ». C'est important, car l'installation nécessite les droits administrateur.

Copie-colle la commande d'installation

Les utilisateurs Windows utilisent cette commande spécifique :

iwr -useb https://openclaw.ai/install.ps1 | iex

Ce script va automatiquement :

Vérifier et configurer WSL2 (s'il n'est pas encore installé)
Installer Node.js
Télécharger et installer OpenClaw
Lancer l'assistant de configuration

Attends la fin de l'installation

Sous Windows, l'installation peut être un peu plus longue (car WSL2 doit peut-être être installé), environ 5 à 10 minutes. Une fois terminé, l'assistant de configuration se lancera automatiquement.

⚠️ Attention utilisateurs Windows : Après l'installation de WSL2, un redémarrage de l'ordinateur peut être nécessaire. Si le script te demande de redémarrer, fais-le d'abord, puis relance la commande d'installation.

📦 Méthode 2 : Installation via npm

Si tu connais déjà Node.js et npm (le gestionnaire de paquets de Node.js), tu peux utiliser cette méthode. Elle te donne plus de contrôle.

Vérifie que Node.js est installé

Ouvre le terminal et tape la commande suivante pour vérifier la version de Node.js :

node --version

Si tu vois v22.x.x ou une version supérieure, c'est bon. Sinon, télécharge et installe la dernière version depuis nodejs.org.

Installe OpenClaw globalement via npm

Dans le terminal, exécute :

npm install -g openclaw@latest

Explication de la commande :

npm install — Utilise npm pour installer un logiciel
-g — Installation globale, pour pouvoir utiliser la commande openclaw de n'importe où
openclaw@latest — Installe la dernière version d'OpenClaw

Lance la configuration et enregistre le service en arrière-plan

Après l'installation, exécute :

openclaw onboard --install-daemon

Cette commande fait deux choses :

onboard — Lance l'assistant de configuration pour te guider dans la mise en place initiale (choix du modèle IA, saisie de la clé API, etc.)
--install-daemon — Enregistre OpenClaw comme service en arrière-plan (daemon), pour qu'il démarre automatiquement au lancement de ton ordinateur

💡 C'est quoi un daemon (processus d'arrière-plan) ? En gros, c'est un programme qui tourne discrètement en arrière-plan. Tu ne vois pas sa fenêtre, mais il est toujours actif. Avec --install-daemon, OpenClaw tournera silencieusement en arrière-plan, prêt à recevoir tes messages à tout moment.

🐳 Méthode 3 : Installation Docker

Si tu aimes utiliser Docker (une technologie de conteneurisation), ou si tu veux faire tourner OpenClaw dans un environnement complètement isolé, cette méthode est faite pour toi.

ℹ️ C'est quoi Docker ? Docker, c'est comme une « boîte virtuelle » dans laquelle tu peux faire tourner des logiciels. Même si le logiciel a un problème, ça n'affecte pas ton ordinateur. Si tu ne sais pas ce qu'est Docker, on te recommande d'utiliser la méthode 1 ou la méthode 2.

Vérifie que Docker est installé

Si tu n'as pas encore Docker, télécharge et installe Docker Desktop depuis docker.com.

Lance le conteneur Docker OpenClaw

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  ghcr.io/openclaw/openclaw:latest

Cette commande télécharge l'image Docker d'OpenClaw et lance le conteneur. Le paramètre -v mappe les fichiers de configuration vers ton ordinateur pour éviter de perdre tes données.

✅ Vérification après installation

Maintenant que l'installation est terminée, vérifions que tout fonctionne. Suis les étapes ci-dessous :

Lance le bilan de santé

openclaw doctor

Cette commande fait un « check-up » complet d'OpenClaw. Elle vérifie que tous les composants fonctionnent correctement. Si tout va bien, tu verras plein de coches vertes.

Vérifie l'état de fonctionnement

openclaw status

Cette commande t'indique si OpenClaw est en cours d'exécution. Si elle affiche « running », tout est en ordre !

Ouvre le tableau de bord Web

openclaw dashboard

Cette commande ouvre automatiquement ton navigateur sur le tableau de bord d'OpenClaw. L'adresse est :

http://127.0.0.1:18789/

Sur ce tableau de bord, tu peux voir tous les paramètres et l'état d'OpenClaw en un coup d'œil !

🎉 Si les trois commandes n'ont renvoyé aucune erreur, félicitations ! OpenClaw est installé avec succès ! Maintenant, direction la section Prise en main rapide pour apprendre à l'utiliser.

🛠️ Problèmes d'installation courants

Tu rencontres un souci ? Pas de panique ! Voici les problèmes les plus fréquents et leurs solutions :

Problème 1 : Commande introuvable (command not found: openclaw)

C'est généralement un problème de variable d'environnement PATH. En gros, ton ordinateur ne sait pas où se trouve la commande openclaw.

Solution :

# Vérifie où openclaw est installé
which openclaw || npm list -g openclaw

# Si tu utilises bash, ajoute le chemin au fichier de config
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Si tu utilises zsh (par défaut sur macOS)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Problème 2 : Version de Node.js trop ancienne

Si tu vois une erreur du type « Node.js v18 is not supported », tu dois mettre à jour Node.js.

Solution :

# Utilise nvm (Node Version Manager) pour gérer les versions de Node.js
# D'abord, installe nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Installe Node.js 22
nvm install 22

# Passe à Node.js 22
nvm use 22

# Vérifie la version
node --version

Problème 3 : Conflit de port (EADDRINUSE)

Si tu vois « EADDRINUSE: address already in use :::18789 », cela signifie que le port 18789 est déjà utilisé par un autre programme.

Solution :

# Trouve le processus qui utilise le port 18789
lsof -i :18789

# Si c'est un ancien processus OpenClaw, arrête-le
openclaw stop

# Puis redémarre
openclaw start

Problème 4 : Permissions insuffisantes (EACCES)

Tu peux rencontrer ce problème en installant globalement via npm sur Linux/macOS.

Solution :

# Méthode A : Change le répertoire d'installation globale de npm
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Puis réinstalle
npm install -g openclaw@latest

⚠️ N'utilise surtout pas sudo npm install -g ! Même si ajouter sudo résout le problème de permissions, cela peut créer d'autres problèmes de sécurité. Utilise plutôt la méthode ci-dessus pour changer le répertoire d'installation globale de npm.

Problème 5 : Timeout réseau

Si le téléchargement est très lent ou échoue, c'est probablement un problème de réseau.

Solution :

# Vérifie ta connexion internet
ping -c 3 registry.npmjs.org

# Si nécessaire, réessaie l'installation
npm install -g openclaw@latest