Installer

Configuration système requise

• Node 24 (recommandé) ou Node 22.19+ - le script d’installation gère cela automatiquement
• macOS, Linux ou Windows - 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 à partir des 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.

macOSLinuxWSL2macOS / Linux / WSL2WindowsWindows (PowerShell)

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 :

macOSLinuxWSL2macOS / Linux / WSL2WindowsWindows (PowerShell)

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, voir Fonctionnement interne de l’installateur.

Méthodes d’installation alternatives

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

Utilisez cette méthode lorsque vous souhaitez garder OpenClaw et Node 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 git-checkout dans le même flux de préfixe. Référence complète : Fonctionnement interne 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 :

npmnpmpnpmbun

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

Note

L’installateur hébergé efface les filtres de fraîcheur npm tels que min-release-ageOpenClawnpmnpm pour l’installation du package OpenClaw. Si vous installez manuellement avec npm, votre propre politique npm s’applique toujours.

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

Note

pnpm nécessite une approbation explicite pour les packages avec des scripts de build. Exécutez pnpm approve-builds -g après la première installation.

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

Note

Bun est pris en charge pour le chemin d’installation global du CLI. Pour le runtime Gateway, Node reste le runtime de démon recommandé.

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 de développement complets.

Installer depuis l’extraction 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 packages

DockerDocker

Déploiements conteneurisés ou sans interface.

Podman

Alternative de conteneur sans privilèges root à Docker.

NixNix

Installation déclarative via le flake Nix.

AnsibleAnsible

Approvisionnement automatisé de flotte.

BunBun

Utilisation en CLI uniquement via l’environnement d’exécution 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 macOSopenclaw 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 de 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.

Kubernetes

Déploiement K8s.

Fly.ioFly.io

Déployer sur Fly.io.

HetznerHetzner

Déploiement Hetzner.

GCPGCP

Déploiement Google Cloud.

Azure

Déploiement Azure.

Railway

Déploiement Railway.

Render

Déploiement Render.

Northflank

Déploiement Northflank.

Mise à jour, migration ou désinstallation

Updating

Garder OpenClaw à jour.

Migrating

Passer à une nouvelle machine.

Uninstall

Supprimer 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 la configuration de Node pour plus de détails.