Fonctionnement interne de l'installateur

Fonctionnement interne de l’installateur

OpenClaw fournit trois scripts d’installation, servis depuis openclaw.ai.

Script	Plateforme	Ce qu’il fait
install.sh	macOS / Linux / WSL	Installe Node si nécessaire, installe OpenClaw via npm (par défaut) ou git, et peut exécuter l’onboarding.
install-cli.sh	macOS / Linux / WSL	Installe Node + OpenClaw dans un préfixe local (~/.openclaw). Pas de droits root requis.
install.ps1	Windows (PowerShell)	Installe Node si nécessaire, installe OpenClaw via npm (par défaut) ou git, et peut exécuter l’onboarding.

Commandes rapides

install.shinstall-cli.shinstall.ps1

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help

iwr -useb https://openclaw.ai/install.ps1 | iex

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun

Note

Si l’installation réussit mais que

openclaw

n’est pas trouvé dans un nouveau terminal, consultez le

Node.js troubleshooting

.

---

install.sh

Tip

Recommandé pour la plupart des installations interactives sur macOS/Linux/WSL.

Flow (install.sh)

1. Detect OS

   Prend en charge macOS et Linux (y compris WSL). Si macOS est détecté, installe Homebrew s’il est manquant.

2. Ensure Node.js 24 by default

   Vérifie la version de Node et installe Node 24 si nécessaire (Homebrew sur macOS, scripts de configuration NodeSource sur Linux apt/dnf/yum). OpenClaw prend toujours en charge Node 22 LTS, actuellement 22.14+, pour la compatibilité.

3. Ensure Git

   Installe Git s’il est manquant.

4. Install OpenClaw

   • méthode npm (par défaut) : installation npm globale - méthode git : clone/mise à jour du dépôt, installation des dépendances avec pnpm, build, puis installation du wrapper à ~/.local/bin/openclaw

5. Post-install tasks

   • Exécute openclaw doctor --non-interactive lors des mises à jour et installations git (au mieux) - Tente l’onboarding lorsque cela est approprié (TTY disponible, onboarding non désactivé, et les vérifications bootstrap/config passent) - Définit SHARP_IGNORE_GLOBAL_LIBVIPS=1 par défaut

Source checkout detection

Si exécuté à l’intérieur d’un checkout OpenClaw (package.json + pnpm-workspace.yaml), le script propose :

• utiliser le checkout (git), ou
• utiliser l’installation globale (npm)

Si aucun TTY n’est disponible et qu’aucune méthode d’installation n’est définie, la valeur par défaut est npm et un avertissement est émis.

Le script se termine avec le code 2 pour une sélection de méthode non valide ou des valeurs --install-method non valides.

Exemples (install.sh)

DefaultSkip onboardingGit installGitHub main via npmDry run

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --version main

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run

Référence des indicateurs

Indicateur	Description
--install-method npm|git	Choisir la méthode d’installation (par défaut : npm). Alias : --method
--npm	Raccourci pour la méthode npm
--git	Raccourci pour la méthode git. Alias : --github
`—version

| Version npm, dist-tag ou spécification de package (par défaut :latest) | | —beta | Utiliser le dist-tag bêta si disponible, sinon revenir àlatest | |—git-dir

| Répertoire de checkout (par défaut :~/openclaw). Alias : —dir | |—no-git-update | Ignorergit pullpour un checkout existant | |—no-prompt | Désactiver les invites | |—no-onboard | Ignorer l'onboarding | |—onboard | Activer l'onboarding | |—dry-run | Afficher les actions sans appliquer les modifications | |—verbose | Activer la sortie de débogage (set -x, logs de niveau notice npm) | | —help | Afficher l'utilisation (-h`) |

Référence des variables d'environnement

Variable	Description
OPENCLAW_INSTALL_METHOD=git|npm	Méthode d’installation
`OPENCLAW_VERSION=latest|next|main|

|

| Version npm, dist-tag ou spécification de package | |OPENCLAW_BETA=0|1 | Utiliser la bêta si disponible | |OPENCLAW_GIT_DIR=

| Répertoire de checkout | |OPENCLAW_GIT_UPDATE=0|1 | Activer/désactiver les mises à jour git | |OPENCLAW_NO_PROMPT=1 | Désactiver les invites | |OPENCLAW_NO_ONBOARD=1 | Ignorer l'onboarding | |OPENCLAW_DRY_RUN=1 | Mode simulation | |OPENCLAW_VERBOSE=1 | Mode débogage | |OPENCLAW_NPM_LOGLEVEL=error|warn|notice | Niveau de log npm | |SHARP_IGNORE_GLOBAL_LIBVIPS=0|1 | Contrôler le comportement de sharp/libvips (défaut :1`) |

---

install-cli.sh

Info

Conçu pour les environnements où vous souhaitez tout sous un préfixe local (défaut

~/.openclaw

) et sans dépendance système Node.

Flux (install-cli.sh)

1. Installer l'exécution Node locale

   Télécharge une archive tar Node LTS prise en charge et figée (la version est intégrée dans le script et mise à jour indépendamment) vers `

   /tools/node-v

   ` et vérifie le SHA-256.

2. Assurer la présence de Git

   Si Git est manquant, tente une installation via apt/dnf/yum sur Linux ou Homebrew sur macOS.

3. Installer OpenClaw sous le préfixe

   Installe avec npm en utilisant `—prefix

   , puis écrit un wrapper vers

   /bin/openclaw`.

Exemples (install-cli.sh)

DefaultCustom prefix + versionAutomation JSON outputRun onboarding

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard

Référence des drapeaux

Flag	Description
`—prefix

| Préfixe d'installation (par défaut :~/.openclaw) | | —version

| Version ou dist-tag OpenClaw (par défaut :latest) | | —node-version

| Version de Node (par défaut :22.22.0) | | —json | Émettre des événements NDJSON | |—onboard | Exécuteropenclaw onboardaprès l'installation | |—no-onboard | Ignorer l'onboarding (par défaut) | |—set-npm-prefix | Sur Linux, forcer le préfixe npm à~/.npm-globalsi le préfixe actuel n'est pas inscriptible | |—help | Afficher l'utilisation (-h`) |

Référence des variables d'environnement

Variable	Description
`OPENCLAW_PREFIX=

| Préfixe d'installation | |OPENCLAW_VERSION=

| Version ou dist-tag OpenClaw | |OPENCLAW_NODE_VERSION=

| Version de Node | |OPENCLAW_NO_ONBOARD=1 | Ignorer l'onboarding | |OPENCLAW_NPM_LOGLEVEL=error|warn|notice| Niveau de log npm | |OPENCLAW_GIT_DIR=

| Chemin de recherche de nettoyage hérité (utilisé lors de la suppression de l'ancien checkout de sous-modulePeekaboo) | | SHARP_IGNORE_GLOBAL_LIBVIPS=0|1 | Contrôler le comportement de sharp/libvips (par défaut :1`) |

---

install.ps1

Flux (install.ps1)

1. S'assurer de l'environnement PowerShell + Windows

   Nécessite PowerShell 5+.

2. Garantir Node.js 24 par défaut

   Si absent, tente l’installation via winget, puis Chocolatey, puis Scoop. Node 22 LTS, actuellement 22.14+, reste pris en charge pour la compatibilité.

3. Installer OpenClaw

   • méthode npm (par défaut) : installation npm globale utilisant le -Tag sélectionné - méthode git : clone/mise à jour du dépôt, installation/construction avec pnpm, et installation du wrapper à %USERPROFILE%\.local\bin\openclaw.cmd

4. Tâches post-installation

   Ajoute le répertoire bin nécessaire au PATH utilisateur lorsque c’est possible, puis exécute openclaw doctor --non-interactive lors des mises à niveau et des installations git (au mieux).

Exemples (install.ps1)

DefaultGit installGitHub main via npmCustom git directoryDry runDebug trace

powershell iwr -useb https://openclaw.ai/install.ps1 | iex

powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git

powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag main

powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"

powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun

powershell # install.ps1 has no dedicated -Verbose flag yet. Set-PSDebug -Trace 1 & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard Set-PSDebug -Trace 0

Référence des drapeaux

Drapeau	Description
-InstallMethod npm|git	Méthode d’installation (par défaut : npm)
`-Tag

| npm dist-tag, version, ou spécification de paquet (par défaut :latest) | | -GitDir

| Répertoire de checkout (par défaut :%USERPROFILE%\openclaw) | | -NoOnboard | Ignorer l'onboarding | |-NoGitUpdate | Ignorergit pull | |-DryRun` | Afficher uniquement les actions |

Référence des variables d'environnement

Variable	Description
OPENCLAW_INSTALL_METHOD=git|npm	Méthode d’installation
`OPENCLAW_GIT_DIR=

| Répertoire de checkout | |OPENCLAW_NO_ONBOARD=1 | Ignorer l'onboarding | |OPENCLAW_GIT_UPDATE=0 | Désactiver git pull | |OPENCLAW_DRY_RUN=1` | Mode simulation |

Note

Si

-InstallMethod git

est utilisé et que Git est absent, le script s’arrête et affiche le lien Git for Windows.

---

CI et automatisation

Utilisez des indicateurs/env vars non interactifs pour des exécutions prévisibles.

install.sh (non-interactive npm)install.sh (non-interactive git)install-cli.sh (JSON)install.ps1 (skip onboarding)

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

bash OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \ curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

bash curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

---

Dépannage

Pourquoi Git est-il requis ?

Git est requis pour la méthode d’installation git. Pour les installations npm, Git est toujours vérifié/installé pour éviter les échecs spawn git ENOENT lorsque les dépendances utilisent des URL git.

Pourquoi npm rencontre-t-il EACCES sur Linux ?

Certaines configurations Linux pointent le préfixe global npm vers des chemins détenus par root. install.sh peut modifier le préfixe vers ~/.npm-global et ajouter des exportations PATH aux fichiers rc du shell (lorsque ces fichiers existent).

problèmes sharp/libvips

Les scripts définissent SHARP_IGNORE_GLOBAL_LIBVIPS=1 par défaut pour éviter que sharp ne soit construit avec la libvips du système. Pour remplacer :

SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

Windows : « npm error spawn git / ENOENT »

Installez Git pour Windows, rouvrez PowerShell, relancez l’installateur.

Windows : « openclaw is not recognized »

Exécutez npm config get prefix et ajoutez ce répertoire à votre PATH utilisateur (pas de suffixe \bin nécessaire sur Windows), puis rouvrez PowerShell.

Windows : comment obtenir une sortie détaillée de l'installateur

install.ps1 n’expose pas actuellement de commutateur -Verbose. Utilisez le traçage PowerShell pour les diagnostics au niveau du script :

Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

openclaw introuvable après l'installation

Généralement un problème de PATH. Voir Dépannage Node.js.