Passer au contenu principal

​
Installation

​
Recommandé : script d’installation

C’est le moyen le plus rapide d’installer. Il détecte votre OS, installe Node si nécessaire, installe OpenClaw et lance l’onboarding. 
curl -fsSL https://openclaw.ai/install.sh | bash
Pour installer sans lancer l’onboarding : 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Pour tous les drapeaux et options CI/automatisation, voir Internes de l’installateur.

​
Configuration système requise

  • Node 24 (recommandé) ou Node 22.14+ — le script d’installation s’en charge automatiquement
  • macOS, Linux ou Windows — Windows natif et WSL2 sont pris en charge ; WSL2 est plus stable. Voir Windows.
  • pnpm n’est nécessaire que si vous compilez depuis les sources

​
Méthodes d’installation alternatives

​
Installateur à préfixe local (install-cli.sh)

Utilisez cette méthode si vous voulez conserver OpenClaw et Node sous un préfixe local tel que ~/.openclaw, sans dépendre d’une installation Node à l’échelle du système : 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Il prend en charge par défaut les installations npm, ainsi que les installations depuis une extraction git dans le même flux à préfixe. Référence complète : Internes de l’installateur.

​
npm, pnpm ou bun

Si vous gérez déjà Node vous-même : 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Si sharp échoue à cause d’un libvips installé globalement :
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
Depuis les sources

Pour les contributeurs ou toute personne qui veut exécuter depuis une extraction locale : 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon
Ou ignorez link et utilisez pnpm openclaw ... depuis le dépôt. Voir Configuration pour les flux de développement complets.

​
Installer depuis GitHub main

npm install -g github:openclaw/openclaw#main

​
Conteneurs et gestionnaires de paquets

Docker

Déploiements conteneurisés ou headless.

Podman

Alternative conteneur rootless à Docker.

Nix

Installation déclarative via flake Nix.

Ansible

Provisionnement automatisé de flotte.

Bun

Utilisation CLI uniquement via le runtime Bun.

​
Vérifier l’installation

openclaw --version      # confirmer que la CLI est disponible
openclaw doctor         # vérifier les problèmes de configuration
openclaw gateway status # vérifier que la Gateway est en cours d’exécution
Si vous voulez 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 : tâche planifiée en premier, avec solution de repli vers un élément de démarrage de session par utilisateur si la création de tâche est refusée

​
Hébergement et déploiement

Déployez OpenClaw sur un serveur cloud ou un VPS :

VPS

N’importe quel VPS Linux

Docker VM

Étapes Docker partagées

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
Mettre à jour, migrer ou désinstaller

Mise à jour

Gardez OpenClaw à jour.

Migration

Déplacez-vous vers une nouvelle machine.

Désinstaller

Supprimez complètement OpenClaw.

​
Dépannage : openclaw introuvable

Si l’installation a réussi mais que openclaw est introuvable dans votre terminal : 
node -v           # Node installé ?
npm prefix -g     # Où se trouvent les packages globaux ?
echo "$PATH"      # Le répertoire global bin est-il dans PATH ?
Si $(npm prefix -g)/bin n’est pas dans votre $PATH, ajoutez-le à votre fichier de démarrage shell (~/.zshrc ou ~/.bashrc) : 
export PATH="$(npm prefix -g)/bin:$PATH"
Ouvrez ensuite un nouveau terminal. Voir Configuration de Node pour plus de détails.