Install overview
Installer
Prérequis système
- Node 24 (recommandé) ou Node 22.16+ - le script d’installation s’en charge automatiquement
- macOS, Linux ou Windows - Windows natif et WSL2 sont tous deux pris en charge ; WSL2 est plus stable. Consultez Windows.
pnpmest nécessaire uniquement si vous compilez depuis les sources
Recommandé : script d’installation
La façon la plus rapide d’installer. Il détecte votre OS, installe Node si nécessaire, installe OpenClaw et lance l’onboarding.
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexPour installer sans exécuter l’onboarding :
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboardWindows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardPour tous les flags et les options CI/automatisation, consultez Fonctionnement interne de l’installateur.
Méthodes d’installation alternatives
Installateur à préfixe local (install-cli.sh)
Utilisez ceci lorsque vous souhaitez 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 | bashIl prend en charge les installations npm par défaut, ainsi que les installations depuis un checkout git 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 par package et par 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
npm install -g openclaw@latestopenclaw onboard --install-daemonpnpm
pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemonbun
bun add -g openclaw@latestopenclaw onboard --install-daemonDépannage : erreurs de build sharp (npm)
Si sharp échoue à cause d’un libvips installé globalement :
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latestDepuis les sources
Pour les contributeurs ou toute personne souhaitant exécuter depuis un checkout local :
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemonOu ignorez le lien et utilisez pnpm openclaw ... depuis l’intérieur du dépôt. Consultez Configuration pour les flux de développement complets.
Installer depuis GitHub main
npm install -g github:openclaw/openclaw#mainConteneurs et gestionnaires de packages
Déploiements conteneurisés ou headless.
Alternative à Docker avec conteneurs rootless.
Installation déclarative via une flake Nix.
Provisionnement automatisé de parc.
Utilisation CLI uniquement via l’environnement d’exécution Bun.
Vérifier l’installation
openclaw --version # confirm the CLI is availableopenclaw doctor # check for config issuesopenclaw gateway status # verify the Gateway is runningSi vous souhaitez un démarrage géré après l’installation :
- macOS : LaunchAgent via
openclaw onboard --install-daemonouopenclaw gateway install - Linux/WSL2 : service utilisateur systemd via les mêmes commandes
- Windows natif : tâche planifiée en premier, avec un élément de connexion par utilisateur dans le dossier de démarrage comme solution de secours 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 :
Mettre à jour, migrer ou désinstaller
Gardez OpenClaw à jour.
Passer à une nouvelle machine.
Supprimer complètement OpenClaw.
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 du 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.