Comment installer OpenClaw

Il y a plus de façons d’installer OpenClaw que de raisons de choisir entre elles. La documentation en recommande une, le script d’installation, et liste les autres pour ceux qui gèrent déjà Node, font tourner des conteneurs, ou préfèrent l’application de bureau à un terminal. Voici chaque méthode, ce qu’elle exige, comment vérifier l’installation, et le prérequis qui piège en premier.

Prérequis

• Node 24.16 ou plus récent, ou 26.1 ou plus récent. La documentation recommande la 26, et l’installateur la provisionne quand Node manque : la 26 sur macOS, la 24 LTS sur Linux.
• macOS, Linux ou Windows ; sous Windows, le choix est entre l’application Hub, l’installateur PowerShell et une passerelle sous WSL2.
• pnpm uniquement si vous compilez depuis les sources.

Les méthodes

• Le script d’installation, recommandé : une ligne curl sur macOS, Linux et WSL2, une ligne PowerShell sur Windows. Il détecte le système, installe Node si nécessaire, installe OpenClaw et lance l’assistant de démarrage ; une option saute cette dernière étape.
• Les applications de bureau : l’installateur signé Windows Hub, et l’application de barre de menus macOS depuis la page des versions GitHub, en dmg ou en zip. Les deux peuvent provisionner une passerelle locale au premier lancement ou se connecter à une passerelle distante.
• L’installateur à préfixe local : garde OpenClaw et Node sous un seul répertoire sans dépendre d’un Node installé pour tout le système.
• npm, pnpm ou bun, si vous gérez Node vous-même ; chacun exige une option qui autorise les scripts de cycle de vie du paquet OpenClaw, et les npm récents les bloquent sans elle.
• Depuis les sources avec un dépôt local, ou directement depuis la branche principale GitHub via l’installateur ; Docker, Podman, Nix et Ansible ont leurs propres pages.

La note sur npm est celle à lire avant de taper : npm 12 bloque par défaut les scripts de cycle de vie non approuvés, l’installation exige donc une option d’autorisation explicite, et la commande d’approbation que npm suggère ne fonctionne pas pour une installation globale. pnpm veut une option d’autorisation de compilation sur l’ajout global. bun veut une option de confiance, et bun 1.4 ou plus récent peut aussi exécuter la ligne de commande et la passerelle, même si Node reste l’environnement principal.

Node reste l’environnement principal, si bien que l’exécutable openclaw ordinaire garde son shebang Node.

Vérifier, puis maintenir en marche

• Trois commandes : afficher la version, lancer doctor pour les problèmes de configuration, vérifier l’état de la passerelle.
• Le démarrage géré : un LaunchAgent sur macOS, un service systemd utilisateur sur Linux et WSL2, une tâche planifiée sur Windows natif avec repli sur le dossier Démarrage, installé par l’assistant de démarrage ou par la commande d’installation de la passerelle.
• Si la commande est introuvable après l’installation, la documentation se termine par une section consacrée précisément à ce cas.

Laquelle choisir

Le script, sauf raison contraire. L’application de bureau si vous préférez ne pas voir de terminal. npm ou pnpm si vous gardez déjà Node à jour et voulez épingler la version. Les sources si vous contribuez. le guide Windows pèse les trois chemins Windows, et OpenClaw sur Docker explique ce que la configuration en conteneur fait et ne fait pas.

Ou aucune d’elles

Installer est la partie courte. Configurer OpenClaw pas à pas déroule les cinq étapes qui suivent, et OpenClaw hébergé sur Diali est la version où l’installation, le service et les mises à jour sont faits sur une instance isolée et où vous commencez au premier message.

• Un script, ou une application de bureau ; le reste est pour ceux qui savent pourquoi.
• Node 24 ou 26, et une option pour les scripts du paquet si vous installez à la main.
• Vérifiez avec version, doctor et status ; puis installez le service.