Node.js¶

La base d’exécution d’OpenClaw est Node 22+. Le script d'installation détectera et installera automatiquement Node — cette page est réservée lorsque vous voulez configurer Node vous-même et vous assurer que tout est bien branché (versions, PATH, installations globales).

Vérifiez votre version¶

Nœud -v

Si cela affiche v22.x.x ou supérieur, vous êtes bien. Si Node n'est pas installé ou que la version est trop ancienne, choisissez une méthode d'installation ci-dessous.

install/node.md¶

Homebrew (recommandé) :

````
```
macOS : Homebrew (`brew install node`) ou un gestionnaire de versions
```
````

Ubuntu / Debian :

`````
````
```bash
curl -fsSL https://deb.nodesource.com/setup_22. | sudo -E bash -
sudo apt-get install -y nodejs
```

**Fedora / RHEL:**

```bash
sudo dnf install nodejs
```

Ou utilisez un gestionnaire de versions (voir ci-dessous).
````
`````

winget (recommandé) :

`````
````
```powershell
winget install OpenJS.NodeJS. TS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

Ou téléchargez l'installateur Windows depuis [nodejs.org](https://nodejs.org/).
````
`````

Les gestionnaires de versions vous permettent de basculer facilement entre les versions de Node. Options populaires :

• fnm — fast, cross-platform
• nvm — largement utilisé sur macOS/Linux
• mise — polygone (Node, Python, Ruby, etc.)

Exemple avec fnm :

fnm install 22
fnm use 22

Si vous utilisez un gestionnaire de versions (nvm/fnm/asdf/etc), assurez‑vous qu’il est initialisé dans le shell que vous utilisez au quotidien (zsh vs bash) afin que le PATH qu’il définit soit présent lorsque vous lancez des installateurs. Si ce n'est pas le cas, openclaw peut ne pas être trouvé dans les nouvelles sessions de terminaux, car le PATH n'inclut pas le répertoire de corbeille de Node.

Problemes courants¶

Si vous pouvez exécuter npm install -g openclaw@latest mais voyez ensuite openclaw: command not found, c’est presque toujours un problème de PATH : le répertoire où npm place les binaires globaux n’est pas dans le PATH de votre shell.¶

Correctif : ajouter le répertoire global npm au PATH

npm prefix -g bash : ~/.bashrc

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

zsh : ~/.zshrc

    ```
        ```
        # macOS / Linux
        export PATH="/path/from/npm/prefix/bin:$PATH"
        ```
    ```

Correctif : éviter sudo npm install -g / erreurs de permissions (Linux)¶

Si npm install -g ... échoue avec EACCES, basculez le préfixe global npm vers un répertoire accessible en écriture par l’utilisateur :

mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"

Rendez persistante la ligne export PATH=... dans le fichier de démarrage de votre shell.