OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

Installer

Configuration requise

  • Node 22.19+, 23.11+ ou 24+ - 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 pour PowerShell ou un Gateway sous WSL2. Consultez Windows.
  • pnpm n’est nécessaire que pour compiler à partir des sources.

Recommandé : script d’installation

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

macOS / Linux / WSL2

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

Windows (PowerShell)

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

Pour effectuer l’installation sans lancer la configuration initiale :

macOS / Linux / WSL2

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

Windows (PowerShell)

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

Pour connaître tous les indicateurs et toutes 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 si vous souhaitez conserver OpenClaw et Node sous un préfixe local tel que ~/.openclaw, sans dépendre d’une installation de Node à l’échelle du système :

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

Par défaut, ce programme prend en charge les installations npm, ainsi que les installations à partir d’un dépôt git extrait, selon le même processus avec préfixe. Référence complète : Fonctionnement interne du programme d’installation.

OpenClaw est déjà installé ? Basculez entre les installations par paquet 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

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

pnpm

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

bun

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

À partir des sources

Pour les contributeurs ou toute personne souhaitant exécuter OpenClaw à partir d’une copie locale du dépôt :

bash
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 création du lien et utiliser pnpm openclaw ... depuis le dépôt. Consultez Configuration pour connaître l’ensemble des processus de développement.

Installation depuis la branche principale du dépôt GitHub

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

Conteneurs et gestionnaires de paquets

Docker

Déploiements conteneurisés ou sans interface graphique.
Podman

Alternative à Docker pour des conteneurs sans privilèges root.
Nix

Installation déclarative au moyen d’un flake Nix.
Ansible

Provisionnement automatisé d’un parc de machines.
Bun

Utilisation limitée à la CLI avec l’environnement d’exécution Bun.

Vérifier l’installation

bash
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

Si vous souhaitez un démarrage géré après l’installation :

  • macOS : LaunchAgent au moyen de openclaw onboard --install-daemon ou openclaw gateway install
  • Linux/WSL2 : service utilisateur systemd au moyen des mêmes commandes
  • Windows natif : tâche planifiée en priorité, avec comme solution de repli un élément de connexion propre à l’utilisateur dans le dossier de démarrage 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, etc.), ou effectuez un déploiement déclaratif sur Render.

VPS

Choisissez un fournisseur.
Machine virtuelle Docker

Étapes communes pour Docker.
Kubernetes

Déploiement K8s.

Mettre à jour, migrer ou désinstaller

Mise à jour

Maintenez OpenClaw à jour.
Migration

Transférez OpenClaw vers une nouvelle machine.
Désinstallation

Supprimez complètement OpenClaw.

Dépannage : commande 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 le PATH de votre shell. Consultez Dépannage de Node.js pour connaître la procédure complète, y compris le chemin sous Windows.

bash
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 ?
Was this useful?
On this page

On this page