Installer

Configuration requise

• Node 22.22.3+, 24.15+ ou 25.9+ - Node 24 est la cible par défaut ; le script d’installation s’en charge automatiquement.
• macOS, Linux ou Windows - Sous Windows, vous pouvez commencer avec l’application Windows Hub native, le programme d’installation de la CLI PowerShell ou un Gateway WSL2. Consultez Windows.
• pnpm n’est nécessaire que pour compiler depuis les sources.

Recommandé : script d’installation

La méthode d’installation la plus rapide. Il détecte votre système d’exploitation, installe Node si nécessaire, installe OpenClaw et lance la configuration initiale.

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

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

Pour effectuer l’installation sans lancer la configuration initiale :

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

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Pour connaître tous les indicateurs et les options de CI et d’automatisation, consultez Fonctionnement interne du programme d’installation.

Autres méthodes d’installation

Programme d’installation avec préfixe local (install-cli.sh)

Utilisez cette méthode pour conserver OpenClaw et Node sous un préfixe local tel que ~/.openclaw, sans dépendre d’une installation système de Node :

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

Elle prend en charge les installations npm par défaut, ainsi que les installations depuis une copie de travail git avec le même flux de préfixe. Référence complète : Fonctionnement interne du programme d’installation.

Déjà installé ? Basculez entre les installations depuis un paquet et depuis git avec openclaw update --channel dev et openclaw update --channel stable. Consultez Mise à jour.

npm, pnpm ou bun

Si vous gérez déjà Node vous-même :

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

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

Depuis les sources

Pour les contributeurs ou toute personne souhaitant exécuter OpenClaw depuis une copie de travail locale :

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

Vous pouvez également ignorer la liaison et utiliser pnpm openclaw ... depuis le dépôt. Consultez Configuration pour connaître l’ensemble des flux de développement.

Installation depuis la branche principale de GitHub

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

Conteneurs et gestionnaires de paquets

Vérifier l’installation

openclaw --version      # vérifier que la CLI est disponibleopenclaw doctor         # rechercher les problèmes de configurationopenclaw gateway status # vérifier que le Gateway est en cours d’exécution

Pour bénéficier d’un démarrage géré après l’installation :

• macOS : LaunchAgent via openclaw onboard --install-daemon ou openclaw gateway install
• Linux/WSL2 : service utilisateur systemd via les mêmes commandes
• Windows natif : d’abord une tâche planifiée, avec comme solution de repli un élément de connexion par utilisateur dans le dossier Startup si la création de la tâche est refusée

Hébergement et déploiement

Déployez OpenClaw sur un serveur cloud ou un VPS. Consultez Serveur Linux pour accéder au sélecteur complet de fournisseurs (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi et plus encore), ou effectuez un déploiement déclaratif sur Render.

Mettre à jour, migrer ou désinstaller

Dépannage : openclaw introuvable

Il s’agit presque toujours d’un problème de PATH : le répertoire global des exécutables npm ne figure pas dans la variable PATH de votre shell. Consultez Dépannage de Node.js pour connaître la solution complète, notamment le chemin sous Windows.

node -v           # Node est-il installé ?npm prefix -g     # Où se trouvent les paquets globaux ?echo "$PATH"      # Le répertoire global des exécutables figure-t-il dans PATH ?