Comment installer OpenClaw — Guide d'installation complet pour Windows, Mac et Linux

L'installation d'OpenClaw prend environ 5 minutes. Vous aurez besoin de Node.js 22+, Git et 8 Go de RAM. Le moyen le plus rapide est une seule commande npm install -g openclaw@latest suivie de l'assistant de configuration. Vous pouvez aussi éviter complètement l'installation avec l'hébergement géré MyClaw.ai.

Ce dont vous avez besoin avant d'installer OpenClaw

Avant d'installer OpenClaw sur votre machine, rassemblez ces prérequis :

ExigenceMinimumRecommandéRAM8Go16GoStockage10Go20GoNode.jsv22v22+ (dernier LTS)SEWin 10 (WSL2) / macOS 12 / Ubuntu 20.04Dernière version stable

Option 1 : Éviter l'installation avec l'hébergement géré

Vous ne voulez pas vous occuper de l'installation ? MyClaw.ai propose un hébergement OpenClaw entièrement géré — votre instance est prête en quelques secondes sans aucune configuration :

• Configuration instantanée — Pas d'installation, pas de configuration, pas de commandes terminal
• Toujours en fonctionnement — Disponibilité 24h/24 et 7j/7 sans laisser votre ordinateur allumé
• Mises à jour automatiques — Toujours sur la dernière version d'OpenClaw

Commencer avec MyClaw.ai →

---

Option 2 : Auto-héberger OpenClaw

Il y a deux façons d'auto-héberger : l'installation globale recommandée (la plus simple) ou la compilation depuis les sources (pour les développeurs).

Recommandé : Installation globale

C'est la façon la plus rapide de faire fonctionner OpenClaw sur n'importe quelle plateforme :

npm install -g openclaw@latest
openclaw onboard --install-daemon

L'assistant de configuration vous guide à travers la configuration de votre gateway, espace de travail, canaux et skills. Le drapeau --install-daemon met en place un service en arrière-plan (launchd sur macOS, systemd sur Linux) pour qu'OpenClaw fonctionne de manière persistante.

Après la configuration, vérifiez votre installation :

openclaw doctor

---

Alternative : Compiler depuis les sources

Si vous préférez un contrôle total ou souhaitez contribuer à OpenClaw, vous pouvez compiler depuis les sources. Suivez les guides spécifiques à chaque plateforme ci-dessous.

Installer OpenClaw sur Windows

WSL2 est fortement recommandé pour exécuter OpenClaw sous Windows. Installez d'abord WSL2, puis suivez les instructions Linux ci-dessous.

Si vous souhaitez quand même l'exécuter nativement sous Windows :

Étape 1 : Installer les prérequis

1. Téléchargez Node.js v22+ (version LTS)
2. Téléchargez Git pour Windows
3. Installez pnpm — le gestionnaire de paquets préféré d'OpenClaw
4. Redémarrez votre terminal après l'installation

Vérifiez les installations :

node --version   # Devrait être v22 ou plus récent
git --version
pnpm --version

Étape 2 : Cloner le dépôt OpenClaw

Ouvrez PowerShell ou l'invite de commandes et exécutez :

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Étape 3 : Installer et compiler

pnpm install
pnpm ui:build
pnpm build

Ceci télécharge tous les paquets nécessaires et compile le projet.

Étape 4 : Exécuter l'assistant de configuration

pnpm openclaw onboard --install-daemon

L'assistant vous guide à travers la configuration d'OpenClaw, y compris la mise en place de votre modèle IA, canaux et espace de travail.

Installer OpenClaw sur macOS

Étape 1 : Installer les prérequis

Le moyen le plus simple est d'utiliser Homebrew :

# Installer Homebrew si nécessaire
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Installer Node.js et Git
brew install node git

# Installer pnpm
brew install pnpm

Étape 2 : Cloner et compiler

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Étape 3 : Exécuter l'assistant de configuration

pnpm openclaw onboard --install-daemon

Ceci met en place un service launchd pour qu'OpenClaw s'exécute automatiquement en arrière-plan.

Permissions macOS

OpenClaw peut demander des permissions d'accessibilité pour l'enregistrement d'écran et les fonctionnalités vocales. Lorsque vous y êtes invité, allez dans :

Réglages Système > Confidentialité et Sécurité > Accessibilité

Ajoutez votre application de terminal à la liste autorisée.

Installer OpenClaw sur Linux (Ubuntu/Debian)

Étape 1 : Installer les prérequis

# Mettre à jour le gestionnaire de paquets
sudo apt update

# Installer Node.js 22 via NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Installer Git
sudo apt install -y git

# Installer pnpm
npm install -g pnpm

Étape 2 : Cloner et compiler

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Étape 3 : Exécuter l'assistant de configuration

pnpm openclaw onboard --install-daemon

Ceci met en place un service utilisateur systemd pour qu'OpenClaw fonctionne de manière persistante en arrière-plan.

Dépannage des problèmes d'installation courants

"pnpm install" échoue avec des erreurs de permissions

Sous Linux/macOS, évitez d'utiliser sudo avec pnpm ou npm. Corrigez plutôt les permissions :

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Erreur "Version de Node non supportée"

OpenClaw nécessite Node.js 22 ou plus récent :

node --version

Si votre version est plus ancienne, téléchargez la dernière depuis nodejs.org ou utilisez nvm pour gérer les versions :

nvm install 22
nvm use 22

Port déjà utilisé

Une autre application utilise le même port. Vous pouvez :

• Arrêter l'application en conflit
• Spécifier un port différent : openclaw gateway --port 18790

Dépendances natives manquantes

Sous Linux, vous pourriez avoir besoin d'outils de compilation supplémentaires :

sudo apt install build-essential

Exécuter l'outil de diagnostic

OpenClaw inclut une commande de diagnostic intégrée qui vérifie votre configuration :

openclaw doctor

Vérifier votre installation

Après avoir installé OpenClaw, exécutez l'outil de diagnostic pour confirmer que tout fonctionne :

openclaw doctor

Puis testez avec une simple commande d'agent :

openclaw agent --message "Bonjour, est-ce que tu fonctionnes ?"

Si OpenClaw répond, votre installation est terminée.

Mettre à jour OpenClaw

Pour mettre à jour votre installation d'OpenClaw vers la dernière version :

Si installé globalement :

openclaw update --channel stable

Si compilé depuis les sources :

cd openclaw
git pull origin main
pnpm install
pnpm ui:build
pnpm build

Prochaines étapes

Maintenant qu'OpenClaw est installé :

• Lisez le Guide de démarrage pour apprendre l'utilisation de base
• En savoir plus sur Qu'est-ce qu'OpenClaw
• Explorez les options d'hébergement OpenClaw pour un fonctionnement 24h/24 et 7j/7