Passer au contenu principal

​
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.
Les utilisateurs du bureau Windows peuvent aussi installer l’application compagnon native Windows Hub, qui inclut la configuration, l’état dans la zone de notification, le chat, le mode nœud et le mode MCP local.
curl -fsSL https://openclaw.ai/install.sh | bash
Pour installer sans exécuter la configuration initiale : 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
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@latest
openclaw onboard --install-daemon
L’installateur hébergé désactive les filtres de fraîcheur npm tels que min-release-age pour l’installation du paquet OpenClaw. Si vous installez manuellement avec npm, votre propre politique npm s’applique toujours.

​
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 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

Docker

Déploiements conteneurisés ou sans interface graphique.

Podman

Alternative à Docker pour conteneurs sans root.

Nix

Installation déclarative via une flake Nix.

Ansible

Provisionnement automatisé de parc.

Bun

Utilisation uniquement CLI via l’environnement d’exécution Bun.

​
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 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 :

VPS

N’importe quel VPS Linux.

Docker VM

Étapes Docker partagées.

Kubernetes

Déploiement K8s.

Fly.io

Déployer sur Fly.io.

Hetzner

Déploiement Hetzner.

GCP

Déploiement Google Cloud.

Azure

Déploiement Azure.

Railway

Déploiement Railway.

Render

Déploiement Render.

Northflank

Déploiement Northflank.

​
Mettre à jour, migrer ou désinstaller

Updating

Garder OpenClaw à jour.

Migrating

Migrer vers une nouvelle machine.

Uninstall

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 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.