Fonctionnement interne du programme d’installation

Detect OS

Prend en charge macOS et Linux, y compris WSL.

Ensure Node.js 24 by default

Vérifie la version de Node et installe Node 24 si nécessaire (Homebrew sous macOS, scripts de configuration NodeSource sous Linux avec apt/dnf/yum). Sous macOS, Homebrew n’est installé que si le programme d’installation en a besoin pour Node ou Git. Node 22.19+ et 23.11+ restent pris en charge à des fins de compatibilité. Sous Alpine/Linux musl, le programme d’installation utilise les paquets apk au lieu de NodeSource ; les dépôts Alpine configurés doivent fournir une version de Node prise en charge (Alpine 3.21 ou version ultérieure au moment de la rédaction).

Ensure Git

Installe Git s’il est absent à l’aide du gestionnaire de paquets détecté, notamment Homebrew sous macOS et apk sous Alpine.

Install OpenClaw

• Méthode npm (par défaut) : installation globale avec npm
• Méthode git : clone ou met à jour le dépôt, installe les dépendances avec pnpm, effectue la compilation, puis installe le lanceur dans ~/.local/bin/openclaw

Post-install tasks

• Localise le binaire openclaw qui vient d’être installé afin d’exécuter les commandes suivantes
• Pour une installation non configurée, lance la configuration initiale avant les vérifications doctor ou Gateway. Avec --no-onboard ou en l’absence de TTY, affiche la commande permettant de terminer ultérieurement la configuration.
• Pour une installation configurée, actualise et redémarre au mieux un service Gateway chargé, puis exécute doctor. Lors des mises à niveau, met à jour les Plugins lorsque cela est possible ou affiche la commande manuelle lors d’une exécution sans interface permettant les invites.
• Lorsque --verify est exécuté, vérifie la version installée et ne contrôle l’état du Gateway qu’après la création d’une configuration.

Install local Node runtime

Télécharge une archive tar épinglée d’une version LTS de Node prise en charge (la version est intégrée au script et mise à jour indépendamment ; valeur par défaut : 22.22.2) dans <prefix>/tools/node-v<version> et vérifie sa somme SHA-256. Sous Alpine/Linux musl, où Node ne publie pas d’archives tar compatibles avec la version épinglée, installe nodejs et npm avec apk, puis lie cet environnement d’exécution au chemin du lanceur situé sous le préfixe. Les dépôts Alpine doivent fournir une version de Node prise en charge (22.19+, 23.11+ ou 24+) ; utilisez Alpine 3.21 ou une version ultérieure si les anciens dépôts ne fournissent que Node 20 ou 21.

Ensure Git

Si Git est absent, tente de l’installer avec apt/dnf/yum/apk sous Linux ou Homebrew sous macOS.

Install OpenClaw under prefix

• Méthode npm (par défaut) : installe OpenClaw sous le préfixe avec npm, puis écrit le lanceur dans <prefix>/bin/openclaw
• Méthode git : clone ou met à jour une copie de travail (~/openclaw par défaut) et écrit également le lanceur dans <prefix>/bin/openclaw

Refresh loaded gateway service

Si un service Gateway est déjà chargé depuis ce même préfixe, le script exécute openclaw gateway install --force, puis openclaw gateway restart, et vérifie au mieux l’état du Gateway.

Vérifier l’environnement PowerShell et Windows

Nécessite PowerShell 5 ou version ultérieure.

Vérifier la présence de Node.js 24 par défaut

S’il est absent, le script tente de l’installer avec winget, puis Chocolatey, puis Scoop. Si aucun gestionnaire de paquets n’est disponible, le script télécharge l’archive zip Windows officielle de Node.js 24 dans %LOCALAPPDATA%\OpenClaw\deps\portable-node et l’ajoute au PATH du processus actuel et de l’utilisateur. Node 22.19+ et 23.11+ restent pris en charge à des fins de compatibilité.

Installer OpenClaw

• Méthode npm (par défaut) : installation npm globale avec l’option -Tag sélectionnée, lancée depuis un répertoire temporaire d’installation accessible en écriture afin que les shells ouverts dans des dossiers protégés tels que C:\ fonctionnent également
• Méthode git : cloner/mettre à jour le dépôt, installer/compiler avec pnpm et installer le lanceur dans %USERPROFILE%\.local\bin\openclaw.cmd. Si Git est absent, le script amorce une installation locale à l’utilisateur de MinGit sous %LOCALAPPDATA%\OpenClaw\deps\portable-git et l’ajoute au PATH du processus actuel et de l’utilisateur.

Effectuer les tâches post-installation

• Ajouter au PATH de l’utilisateur le répertoire des exécutables requis lorsque cela est possible
• Actualiser au mieux un service Gateway chargé (openclaw gateway install --force, puis redémarrage)
• Exécuter openclaw doctor --non-interactive lors des mises à niveau et des installations git (au mieux)

Gérer les échecs

Les installations via iwr ... | iex et bloc de script signalent une erreur bloquante sans fermer la session PowerShell actuelle. Les installations directes via powershell -File / pwsh -File se terminent toujours avec un code différent de zéro pour l’automatisation.