Fonctionnement interne du programme d’installation

Détecter le système d’exploitation

Prend en charge macOS et Linux (y compris WSL).

Garantir Node.js 24 par défaut

Vérifie la version de Node et installe Node 24 si nécessaire (Homebrew sur macOS, scripts de configuration NodeSource sur Linux avec apt/dnf/yum). Sur macOS, Homebrew n’est installé que lorsque le programme d’installation en a besoin pour Node ou Git. Node 22.22.3+, Node 24.15+ et Node 25.9+ sont pris en charge ; Node 23 ne l’est pas. Sur Linux Alpine/musl, le programme d’installation utilise les paquets apk au lieu de NodeSource et vérifie la version réelle de SQLite liée. Les flux de paquets Alpine stables actuels peuvent fournir une version suffisamment récente de Node avec une version vulnérable de SQLite système ; dans ce cas, utilisez plutôt un conteneur node:24-alpine officiel ou un hôte basé sur glibc.

Garantir la présence de Git

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

Installer OpenClaw

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

Tâches après l’installation

• Résout le binaire openclaw qui vient d’être installé pour les commandes suivantes
• Pour une installation non configurée, lance la configuration initiale avant les sondes doctor ou Gateway. Avec --no-onboard ou sans TTY, affiche la commande permettant de terminer la configuration ultérieurement.
• Pour une installation configurée, actualise et redémarre au mieux un service Gateway chargé, puis exécute doctor. Les mises à niveau mettent à jour les plugins lorsque cela est possible ou affichent la commande manuelle lors d’une exécution sans interface avec les invites activées.
• Lorsque --verify s’exécute, vérifie la version installée et ne contrôle l’état du Gateway qu’une fois la configuration présente.

Installer l’environnement d’exécution Node local

Télécharge une archive tar d’une version LTS de Node prise en charge et épinglée (la version est intégrée au script et mise à jour indépendamment, par défaut 24.15.0) dans <prefix>/tools/node-v<version>, puis vérifie son SHA-256. Linux ARMv7 utilise Node 22.22.3, car les binaires ARMv7 officiels de Node 24+ ne sont pas disponibles. Sur Linux Alpine/musl, où Node ne publie pas d’archives tar compatibles avec l’environnement d’exécution épinglé, installe nodejs et npm avec apk, puis vérifie Node ainsi que la bibliothèque SQLite réellement liée. Les flux de paquets Alpine stables actuels peuvent encore lier une version vulnérable de SQLite même avec une version suffisamment récente de Node ; utilisez un conteneur node:24-alpine officiel ou un hôte basé sur glibc lorsque le contrôle de sécurité rejette le paquet.

Garantir la présence de Git

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

Installer OpenClaw sous le préfixe

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

Actualiser le service Gateway chargé

Si un service Gateway est déjà chargé depuis ce même préfixe, le script exécute openclaw gateway install --force, qui active le service de remplacement, puis sonde au mieux l’état du Gateway.

Vérifier l’environnement PowerShell et Windows

Nécessite PowerShell 5+.

Vérifier Node.js 24 par défaut

S’il est absent, 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.22.3+, Node 24.15+ et Node 25.9+ sont pris en charge ; Node 23 ne l’est pas.

Installer OpenClaw

• Méthode npm (par défaut) : installation npm globale à l’aide de la valeur -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 comme C:\ fonctionnent tout de même
• Méthode git : clone/met à jour le dépôt, effectue l’installation et la compilation avec pnpm, puis installe le wrapper dans %USERPROFILE%\.local\bin\openclaw.cmd. Si Git est absent, le script amorce une version MinGit locale à l’utilisateur sous %LOCALAPPDATA%\OpenClaw\deps\portable-git et l’ajoute au PATH du processus actuel et de l’utilisateur.

Effectuer les tâches après l’installation

• Ajoute le répertoire de binaires requis au PATH de l’utilisateur lorsque cela est possible
• Actualise au mieux un service Gateway chargé (openclaw gateway install --force, puis redémarrage)
• Exécute 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.