Passer au contenu principal

​
Aperçu de l’installation

Déjà suivi Pour commencer ? Vous êtes prêt — cette page est destinée aux méthodes alternatives d’installation, aux instructions spécifiques à la plate-forme et à la maintenance.

​
Configuration requise

Sous Windows, nous recommandons fortement d’exécuter OpenClaw sous WSL2.

​
Choisir votre méthode d’installation

Le script d’installation est le moyen recommandé pour installer OpenClaw. Il gère la détection de Node, l’installation et la prise en main en une seule étape.

Installer script

Télécharge la CLI, l’installe globalement via npm et lance l’assistant de prise en main.
curl -fsSL https://openclaw.ai/install.sh | bash
C’est tout — le script gère la détection de Node, l’installation et la prise en main.Pour ignorer la prise en main et simplement installer le binaire :
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Pour tous les flags, variables d’environnement et options CI/automatisation, consultez Installer internals.
Si vous disposez déjà de Node 22+ et préférez gérer l’installation vous-même :
npm install -g openclaw@latest
openclaw onboard --install-daemon
Si libvips est installé globalement (courant sur macOS via Homebrew) et que sharp échoue, forcez les binaires précompilés :
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
Si vous voyez sharp: Please add node-gyp to your dependencies, installez les outils de build (macOS : Xcode CLT + npm install -g node-gyp) ou utilisez la variable d’environnement ci-dessus.
Pour les contributeurs ou toute personne souhaitant exécuter depuis un dépôt local.
1

Clone and build

Clonez le dépôt OpenClaw repo et compilez :
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
2

Link the CLI

Rendez la commande openclaw disponible globalement :
pnpm link --global
Sinon, ignorez le lien et exécutez les commandes via pnpm openclaw ... depuis le dépôt.
3

Run onboarding

openclaw onboard --install-daemon
Pour des workflows de développement plus avancés, consultez Setup.

​
Autres options d’installation

Docker

Déploiements confinés ou sans interface graphique.

Podman

Conteneur rootless : exécutez setup-podman.sh une fois, puis le script de lancement.

Nix

Installation déclarative via Nix.

Ansible

Provisionnement automatisé de flotte.

Bun

Utilisation CLI uniquement via le runtime Bun.

​
Après l’installation

Vérifiez que tout fonctionne : 
openclaw doctor         # vérifier les problèmes de configuration
openclaw status         # gateway status
openclaw dashboard      # ouvrir l'interface navigateur
Si vous avez besoin de chemins d’exécution personnalisés, utilisez :
  • OPENCLAW_HOME pour les chemins internes basés sur le répertoire personnel
  • OPENCLAW_STATE_DIR pour l’emplacement de l’état mutable
  • OPENCLAW_CONFIG_PATH pour l’emplacement du fichier de configuration
Voir Variables d’environnement pour la priorité et les détails complets.

​
Dépannage : openclaw introuvable

Diagnostic rapide :
node -v
npm -v
npm prefix -g
echo "$PATH"
Si $(npm prefix -g)/bin (macOS/Linux) ou $(npm prefix -g) (Windows) n’est pas présent dans votre $PATH, votre shell ne peut pas trouver les binaires npm globaux (y compris openclaw).Correctif — ajoutez-le à votre fichier de démarrage du shell (~/.zshrc ou ~/.bashrc) :
export PATH="$(npm prefix -g)/bin:$PATH"
Sous Windows, ajoutez la sortie de npm prefix -g à votre PATH.Puis ouvrez un nouveau terminal (ou rehash dans zsh / hash -r dans bash).

​
Mise à jour / désinstallation

Updating

Maintenez OpenClaw à jour.

Migrating

Déplacer vers une nouvelle machine.

Uninstall

Supprimez complètement OpenClaw.