Installer

Prérequis système

• Node 24 (recommandé) ou Node 22.19+ - le script d’installation gère cela automatiquement
• macOS, Linux ou Windows - les utilisateurs Windows peuvent commencer avec l’application native Windows Hub, le programme d’installation CLI PowerShell ou un Gateway WSL2. Consultez Windows.
• pnpm n’est nécessaire que si vous compilez depuis les sources

Recommandé : script d’installation

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

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

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

Pour installer sans exécuter la configuration initiale :

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

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

Pour tous les indicateurs et les options CI/automatisation, consultez Fonctionnement interne de l’installateur.

Méthodes d’installation alternatives

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

Utilisez ceci lorsque 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 les installations npm par défaut, ainsi que les installations depuis un checkout git dans le même flux avec préfixe. Référence complète : Fonctionnement interne de l’installateur.

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 install -g openclaw@latestopenclaw onboard --install-daemon

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

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

Depuis 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-daemon

Vous pouvez aussi ignorer le lien et utiliser pnpm openclaw ... depuis l’intérieur du dépôt. Consultez Configuration pour les workflows de développement complets.

Installer depuis le checkout main de GitHub

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

Conteneurs et gestionnaires de paquets

Vérifier l’installation

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

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 un élément de connexion dans le dossier de démarrage par utilisateur en solution de repli 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

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 au fichier de démarrage de votre 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.