Fonctionnement interne de l'installateur

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

Commandes rapides

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

ℹ️ Si l'installation réussit mais que openclaw n'est pas trouvé dans un nouveau terminal, consultez le dépannage Node.js.

install.sh

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

Déroulement (install.sh)

Étape 1 : Détection de l'OS

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

Étape 2 : Vérification de Node.js 22+

Vérifie la version de Node et installe Node 22 si nécessaire (Homebrew sur macOS, scripts de configuration NodeSource sur apt/dnf/yum Linux).

Étape 3 : Vérification de Git

Installe Git s'il est manquant.

Étape 4 : Installation d'OpenClaw

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

Étape 5 : Tâches post-installation

• Exécute openclaw doctor --non-interactive lors des mises à niveau et des installations git (meilleur effort)
• Tente l'intégration lorsque c'est approprié (TTY disponible, intégration non désactivée, et les vérifications bootstrap/config passent)
• Définit par défaut SHARP_IGNORE_GLOBAL_LIBVIPS=1

Détection d'un checkout source

Si exécuté dans 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, il utilise par défaut npm et avertit. Le script se termine avec le code 2 pour une sélection de méthode invalide ou des valeurs --install-method invalides.

Exemples (install.sh)

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

install-cli.sh

ℹ️ Conçu pour les environnements où vous voulez tout sous un préfixe local (par défaut ~/.openclaw) et sans dépendance système Node.

Déroulement (install-cli.sh)

Étape 1 : Installation du runtime Node local

Télécharge l'archive Node (par défaut 22.22.0) vers <prefix>/tools/node-v<version> et vérifie le SHA-256.

Étape 2 : Vérification de Git

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

Étape 3 : Installation d'OpenClaw sous le préfixe

Installe avec npm en utilisant --prefix <prefix>, puis écrit le wrapper dans <prefix>/bin/openclaw.

Exemples (install-cli.sh)

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

install.ps1

Déroulement (install.ps1)

Étape 1 : Vérification de PowerShell + environnement Windows

Nécessite PowerShell 5+.

Étape 2 : Vérification de Node.js 22+

S'il est manquant, tente une installation via winget, puis Chocolatey, puis Scoop.

Étape 3 : Installation d'OpenClaw

• Méthode npm (par défaut) : installation globale via npm en 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

Étape 4 : Tâches post-installation

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

Exemples (install.ps1)

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

ℹ️ Si -InstallMethod git est utilisé et que Git est manquant, le script se termine et affiche le lien vers Git pour Windows.

CI et automatisation

Utilisez des drapeaux/variables d'environnement non interactifs pour des exécutions prévisibles.

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

Dépannage

InstallationDocker