Installation

Vous avez deja suivi Premiers pas ? Tout est en place — cette page couvre les methodes d’installation alternatives, les instructions specifiques aux plateformes et la maintenance.

Configuration requise

Node 24 (recommande) (Node 22 LTS, actuellement 22.16+, est toujours pris en charge pour la compatibilite ; le script d’installation installera Node 24 si absent)
macOS, Linux ou Windows
pnpm uniquement si vous compilez depuis les sources

Remarque : Sous Windows, nous recommandons fortement d’executer OpenClaw sous WSL2.

Methodes d’installation

Astuce : Le script d’installation est la methode recommandee pour installer OpenClaw. Il gere la detection de Node, l’installation et le processus d’accueil en une seule etape.

Avertissement : Pour les VPS/hebergements cloud, evitez si possible les images marketplace tierces “en un clic”. Preferez une image OS propre (par exemple Ubuntu LTS), puis installez OpenClaw vous-meme avec le script d’installation.

Script d'installation

Telecharge le CLI, l'installe globalement via npm et lance l'assistant d'accueil.


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



C'est tout — le script gere la detection de Node, l'installation et l'accueil.

Pour sauter l'accueil et installer uniquement le binaire :


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```

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



Pour tous les drapeaux, variables d'environnement et options CI/automatisation, consultez [Details de l'installateur](/docs/install/installer).

npm / pnpm

Si vous gerez deja Node vous-meme, nous recommandons Node 24. OpenClaw prend toujours en charge Node 22 LTS, actuellement `22.16+`, pour la compatibilite :


  #### npm
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <details>

Erreurs de compilation sharp ?

      Si libvips est installe globalement (courant sur macOS via Homebrew) et que `sharp` echoue, forcez les binaires precompiles :

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

      Si vous voyez `sharp: Please add node-gyp to your dependencies`, installez les outils de compilation (macOS : Xcode CLT + `npm install -g node-gyp`) ou utilisez la variable d'environnement ci-dessus.
    </details>

  #### pnpm
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approuver openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    > **Remarque :** pnpm necessite une approbation explicite pour les packages avec des scripts de compilation. Apres la premiere installation qui affiche l'avertissement "Ignored build scripts", executez `pnpm approve-builds -g` et selectionnez les packages listes.

Depuis les sources

Pour les contributeurs ou toute personne souhaitant executer depuis un checkout local.


  ### Etape 1 : Cloner et compiler
    Clonez le [depot OpenClaw](https://github.com/openclaw/openclaw) et compilez :

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```

  ### Etape 2 : Lier le CLI
    Rendez la commande `openclaw` disponible globalement :

    ```bash
    pnpm link --global
    ```

    Vous pouvez aussi ignorer le lien et executer les commandes via `pnpm openclaw ...` depuis le depot.

  ### Etape 3 : Lancer l'accueil
    ```bash
    openclaw onboard --install-daemon
    ```



Pour des workflows de developpement plus avances, consultez [Configuration](/docs/start/setup).

Autres methodes d’installation

Docker — Deploiements containerises ou headless.
Podman — Conteneur rootless : executez setup-podman.sh une fois, puis le script de lancement.
Nix — Installation declarative via Nix.
Ansible — Provisionnement automatise de flottes.
Bun — Utilisation CLI uniquement via le runtime Bun.

Apres l’installation

Verifiez que tout fonctionne :

openclaw doctor         # verifier les problemes de configuration
openclaw status         # etat de la passerelle
openclaw dashboard      # ouvrir l'interface web

Si vous avez besoin de chemins d’execution personnalises, utilisez :

OPENCLAW_HOME pour les chemins internes bases sur le repertoire personnel
OPENCLAW_STATE_DIR pour l’emplacement de l’etat mutable
OPENCLAW_CONFIG_PATH pour l’emplacement du fichier de configuration

Consultez Variables d’environnement pour la priorite et tous les details.

Depannage : `openclaw` introuvable

Diagnostic et correction du 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 dans votre $PATH, votre shell ne peut pas trouver les binaires npm globaux (y compris openclaw).

Correction — ajoutez-le a votre fichier de demarrage shell (~/.zshrc ou ~/.bashrc) :

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

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

Ouvrez ensuite un nouveau terminal (ou rehash dans zsh / hash -r dans bash).

Mise a jour / desinstallation

Mise a jour — Gardez OpenClaw a jour.
Migration — Demenagez vers une nouvelle machine.
Desinstallation — Supprimez OpenClaw completement.