Installer

Configuration système requise

Node 24 (recommandé) ou Node 22.19+ - le script d’installation gère cela automatiquement
macOS, Linux ou Windows - le Windows natif et WSL2 sont tous deux pris en charge ; WSL2 est plus stable. Voir Windows.
pnpm n’est nécessaire que si vous compilez depuis les sources

Recommandé : script d’installation

Le moyen le plus rapide d’installer. Il détecte votre système d’exploitation, installe Node si nécessaire, installe OpenClaw et lance l’intégration.

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

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

Pour installer sans lancer l’intégration :

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

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

Pour tous les indicateurs et options d’automatisation CI, consultez Détails de l’installateur.

Méthodes d’installation alternatives

Installateur avec préfixe local (`install-cli.sh`)

Utilisez ceci lorsque vous souhaitez qu’OpenClaw et Node soient conservés sous un préfixe local tel que OpenClaw~/.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 les installations npm par défaut, ainsi que les installations par git-checkout dans le même flux de préfixe. Référence complète : Détails de l’installateur.

Déjà installé ? Basculez entre les installations de package et git avec openclaw update --channel dev et openclaw update --channel stable. Voir Mise à jour.

npm, pnpm ou bun

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

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

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

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

Dépannage : erreurs de construction sharp (npm)

Si sharp échoue en raison d’une libvips installée globalement :

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Depuis la source

Pour les contributeurs ou toute personne souhaitant exécuter depuis une extraction locale :

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

Ou ignorez le lien et utilisez pnpm openclaw ... depuis l’intérieur du dépôt. Voir Configuration pour les flux de travail complets de développement.

Installer depuis la branche main de GitHub

npm install -g github:openclaw/openclaw#main

Conteneurs et gestionnaires de paquets

Docker

Déploiements conteneurisés ou sans tête.

Podman

Alternative de conteneur sans privilèges racine à Docker.

NixNix

Installation déclarative via le flake Nix.

AnsibleAnsible

Approvisionnement automatisé de flotte.

BunBun

Utilisation en ligne de commande uniquement via le runtime Bun.

Vérifier l’installation

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running

Si vous souhaitez 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 d’abord, avec un élément de connexion de dossier Démarrage par utilisateur en repli si la création de la tâche est refusée

Hébergement et déploiement

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

VPS

N’importe quel VPS Linux

DockerDocker VM

Étapes Docker partagées

K8s

Fly.io

Hetzner

Google Cloud

Mise à jour, migration ou désinstallation

Updating

Gardez OpenClaw à jour.

Migrating

Déplacez-vous vers une nouvelle machine.

Uninstall

Supprimez OpenClaw complètement.

Dépannage : `openclaw` introuvable

Si l’installation a réussi mais que openclaw est introuvable dans votre terminal :

node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?

Si $(npm prefix -g)/bin n’est pas dans votre $PATH, ajoutez-le à votre fichier de démarrage de shell (~/.zshrc ou ~/.bashrc) :

export PATH="$(npm prefix -g)/bin:$PATH"

Ouvrez ensuite un nouveau terminal. Consultez Configuration de Node pour plus de détails.