Skip to main content

​
Configuration requise

  • Node 22.22.3+, 24.15+ ou 25.9+ - 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 PowerShell ou un Gateway WSL2. Consultez Windows.
  • pnpm n’est nécessaire que pour compiler 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.
Sous Windows, vous pouvez également installer l’application compagnon native Windows Hub, qui comprend la configuration, l’état dans la zone de notification, le chat, le mode Node et le mode MCP local.
Pour effectuer l’installation sans lancer la configuration initiale :
Pour connaître tous les indicateurs et 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 pour conserver OpenClaw et Node sous un préfixe local tel que ~/.openclaw, sans dépendre d’une installation système de Node :
Elle prend en charge les installations npm par défaut, ainsi que les installations depuis une copie de travail git avec le même flux de préfixe. Référence complète : Fonctionnement interne du programme d’installation. Déjà installé ? Basculez entre les installations depuis un paquet et depuis 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 :
Le programme d’installation hébergé efface les filtres d’actualisation npm tels que min-release-age pour l’installation du paquet OpenClaw. Si vous effectuez l’installation manuellement avec npm, votre propre politique npm continue de s’appliquer.

​
Depuis les sources

Pour les contributeurs ou toute personne souhaitant exécuter OpenClaw depuis une copie de travail locale :
Vous pouvez également ignorer la liaison et utiliser pnpm openclaw ... depuis le dépôt. Consultez Configuration pour connaître l’ensemble des flux de développement.

​
Installation depuis la branche principale de GitHub

​
Conteneurs et gestionnaires de paquets

Docker

Déploiements conteneurisés ou sans interface graphique.

Podman

Alternative sans privilèges root à Docker.

Nix

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

Ansible

Provisionnement automatisé d’un parc de machines.

Bun

Programme facultatif d’installation des dépendances et d’exécution des scripts de paquet.

​
Vérifier l’installation

Pour bénéficier d’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 : d’abord une tâche planifiée, avec comme solution de repli un élément de connexion par utilisateur dans le dossier Startup 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 et plus encore), ou effectuez un déploiement déclaratif sur Render.

VPS

Choisissez un fournisseur.

VM Docker

Étapes Docker partagées.

Kubernetes

Déploiement K8s.

​
Mettre à jour, migrer ou désinstaller

Mise à jour

Maintenez OpenClaw à jour.

Migration

Migrez vers une nouvelle machine.

Désinstallation

Supprimez complètement OpenClaw.

​
Dépannage : 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 la variable PATH de votre shell. Consultez Dépannage de Node.js pour connaître la solution complète, notamment le chemin sous Windows.