Le script d’installation d’OpenClaw

L’installateur en une ligne est la façon recommandée par la documentation d’obtenir OpenClaw, et la page sur ses rouages explique ce que fait vraiment cette ligne. Il y a trois scripts, servis depuis le domaine du projet : le principal pour macOS, Linux et WSL, une variante sans root qui installe dans un préfixe local, et un script PowerShell pour Windows. Voici ce que fait chacun, la règle Node qu’ils appliquent tous, leur comportement avec nvm et un dépôt source, les options qui les rendent scriptables, et les étapes d’après installation qui décident si l’assistant de démarrage se lance.

Les trois scripts

• Le script principal : détecte le système, s’assure d’un Node pris en charge, s’assure de Git, installe OpenClaw via npm par défaut ou depuis git, et peut lancer l’assistant de démarrage.
• Le script CLI : installe Node et OpenClaw dans un préfixe local sous le répertoire OpenClaw, via npm ou git, sans root, sur macOS, Linux, WSL et FreeBSD.
• Le script PowerShell : l’équivalent Windows, qui installe Node via winget, Chocolatey ou Scoop au besoin, ou un repli portable.

La règle Node

Les trois veulent Node 24.16 ou plus récent, ou 26.1 ou plus récent, avec une bibliothèque SQLite qui survit à une réinitialisation du journal d’écriture anticipée ; Node 22, 23 et 25 ne sont pas pris en charge. Quand Node manque et que nvm n’est pas détecté, le script principal installe Node 26 via Homebrew sur macOS et la ligne Node 24 LTS via NodeSource sur Linux ; un Node fourni par un paquet RPM qui lie un SQLite non sûr est laissé en place pendant qu’OpenClaw reçoit un environnement en espace utilisateur. Avant de toucher aux paquets, chaque installateur sonde le npm exact qu’il va utiliser, et les versions récentes de npm reçoivent une approbation de scripts limitée au seul paquet OpenClaw. Lors des mises à niveau, les scripts lancent la réparation du docteur, et la bannière de succès n’apparaît qu’après réussite de la réparation et de la vérification.

Node 24.16+ et Node 26.1+ sont pris en charge ; Node 22, 23 et 25 ne le sont pas.

nvm, dépôts, options

• Avec nvm présent, le script garde un Node actif compatible, vérifie les versions installées dans nvm, et propose d’installer Node 26 dans ce nvm, en demandant d’abord s’il faut épingler l’alias par défaut courant ; il n’installe jamais un second nvm et ne réécrit jamais les profils de shell.
• Lancé dans un dépôt OpenClaw, le script propose le dépôt ou une installation npm globale ; sans terminal et sans méthode définie, il prend npm par défaut et avertit. La méthode git accepte un SHA de commit complet et l’extrait détaché avec un fichier de verrouillage figé.
• Les options : la méthode d’installation, une version, une étiquette de distribution ou une spécification de paquet, un commutateur beta, le répertoire du dépôt, sans invite, sans ou avec assistant de démarrage, une vérification après installation, un essai à blanc et le mode verbeux ; les mêmes choix existent en variables d’environnement pour l’intégration continue.

Comment installer OpenClaw place le script à côté de npm, pnpm, bun, des sources, de Docker et des applications de bureau, et La configuration requise pour OpenClaw couvre la machine sur laquelle il atterrit.

Après l’installation

Le script résout le binaire tout juste installé, et pour une installation non configurée lance l’assistant de démarrage avant toute sonde du docteur ou de la passerelle ; avec l’option sans assistant ou sans terminal, il imprime la commande pour terminer plus tard. Pour une installation configurée, il rafraîchit et redémarre au mieux un service de passerelle chargé et lance le docteur de réparation, où les échecs de réparation de mise à niveau sont fatals et les échecs de mise à jour d’extensions sont des avertissements. Mettre à jour OpenClaw est là où ce chemin de mise à niveau continue.

Sur Diali

Sur Diali, il n’y a ni installateur à lancer ni Node à maintenir dans les versions prises en charge : chaque release est installée de notre côté et testée sur nos propres assistants avant d’atteindre le vôtre. OpenClaw hébergé sur Diali est l’assistant.

• Trois scripts, une règle Node, npm par défaut.
• nvm est respecté, jamais remplacé ; un dépôt est proposé, jamais supposé.
• Sans assistant et vérification sont les options d’une installation sans écran.