Aperçu de l’installation¶

Déjà suivi [Pour commencer] (/start/getting-started ) ? Vous êtes prêt — cette page est destinée aux méthodes alternatives d'installation, aux instructions spécifiques à la plate-forme et à la maintenance.

Configuration requise¶

• Node 22+ (le script d'installation de l'installateur l'installera s'il est manquant)
• macOS, Linux ou Windows via WSL2
• pnpm uniquement si vous compilez depuis les sources

Sous Windows, nous recommandons fortement d’exécuter OpenClaw sous WSL2.

Choisir votre methode d’installation¶

Le script d'installation est le moyen recommandé pour installer OpenClaw. Il gère la détection, l'installation et l'intégration des nœuds en une seule étape.

Installe openclaw globalement via npm et lance la prise en main.

````
```
<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install. h | bash
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    iwr -useb https://openclaw. i/install. s1 | iex
    ```
  </Tab>
</Tabs>

C'est tout — le script gère la détection de Node, installation et embarquement.

Pour ignorer l'intégration et juste installer le binaire :

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw. i/install. h | bash -s -- --no-onboard
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw. i/install. s1))) -NoOnboard
    ```
  </Tab>
</Tabs>

Pour tous les drapeaux, env vars, and CI/automation options, see [Installer internals](/install/installer).
```
````

Si vous disposez déjà de Node2+ et préférez gérer l’installation vous-même:

````
```
<Tabs>
  <Tab title="npm">
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Accordion title="erreurs de build sharp�?">
      Si libvips est installé globalement (courant sur macOS via Homebrew) et que `sharp` échoue, forcez les binaires précompilés�:

      ```bash
      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
      ```

      Si vous voyez `sharp: Please add node-gyp to your dependencies`, installez soit les outils de build (macOS�: Xcode CLT + `npm install -g node-gyp`), soit utilisez la variable d’environnement ci-dessus.
    </Accordion>
  </Tab>
  <Tab title="pnpm">
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    <Note>
    pnpm nécessite une approbation explicite pour les paquets contenant des scripts de build. Après que la première installation affiche l’avertissement «�Ignored build scripts�», exécutez `pnpm approve-builds -g` et sélectionnez les paquets listés.
    </Note>
  </Tab>
</Tabs>
```
````

Pour les contributeurs ou toute personne souhaitant exécuter depuis un dépôt local.

````
```
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build
openclaw onboard --install-daemon
```
````

Autres options d’installation¶

déploiements confinés ou sans tête. Rootless container: run setup-podman.sh once, then the launch script. Installation déclarative via Nix. provisionnement automatique de la flotte. Utilisation CLI-seulement via le runtime Bun.

Apres l’installation¶

Vérifiez que tout fonctionne :

openclaw doctor # vérifier les problèmes de configuration
openclaw status # gateway status
openclaw dashboard # ouvrir l'interface utilisateur du navigateur

Si vous avez besoin de chemins d’exécution personnalisés, utilisez :

• OPENCLAW_HOME pour les chemins internes basés sur le répertoire personnel
• OPENCLAW_STATE_DIR pour l’emplacement de l’état mutable
• OPENCLAW_CONFIG_PATH pour l’emplacement du fichier de configuration

Voir Variables d’environnement pour la priorité et les détails complets.

Depannage : openclaw introuvable (PATH)¶

Diagnostic rapide :

node -v
npm -v
npm prefix -g
echo "$PATH"

Si $(npm prefix -g)/bin (macOS/Linux) ou $(npm prefix -g) (Windows) n’est pas present dans echo "$PATH", votre shell ne peut pas trouver les binaires npm globaux (y compris openclaw).

Correctif : ajoutez-le a votre fichier de demarrage du shell (zsh : ~/.zshrc, bash : ~/.bashrc) :

# macOS / Linux
export PATH="$(npm prefix -g)/bin:$PATH"

Sous Windows, ajoutez la sortie de npm prefix -g a votre PATH.

Puis ouvrez un nouveau terminal (ou rehash dans zsh / hash -r dans bash).

Mise a jour / desinstallation¶

Maintenez OpenClaw à jour. Déplacer vers une nouvelle machine. Supprimez complètement OpenClaw.