Installer

# Configuration requise

• Node 24 (recommandé) ou Node 22.14+ - 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. 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 OS, installe Node si nécessaire, installe OpenClaw et lance l’onboarding.

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

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

Pour installer sans lancer l’onboarding :

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 de 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@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

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

# Depuis les sources

Pour les contributeurs ou toute personne souhaitant exécuter depuis un checkout local :

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw 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 GitHub main

npm install -g github:openclaw/openclaw#main

# Conteneurs et gestionnaires de paquets

# 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 en premier, avec un élément de connexion par utilisateur dans le dossier Startup comme 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 :

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

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