Node.js

OpenClaw necessite Node 22.16 ou superieur. Node 24 est le runtime par defaut et recommande pour les installations, le CI et les workflows de release. Node 22 reste pris en charge via la ligne LTS active. Le script d’installation detectera et installera Node automatiquement — cette page est destinee a ceux qui souhaitent configurer Node eux-memes et s’assurer que tout est correctement en place (versions, PATH, installations globales).

Verifier votre version

node -v

Si cela affiche v24.x.x ou superieur, vous etes sur la version par defaut recommandee. Si cela affiche v22.16.x ou superieur, vous etes sur le chemin Node 22 LTS supporte, mais nous recommandons quand meme de passer a Node 24 quand c’est pratique. Si Node n’est pas installe ou la version est trop ancienne, choisissez une methode d’installation ci-dessous.

Installer Node

macOS

**Homebrew** (recommande) :

```bash
brew install node
```

Ou telechargez l'installateur macOS depuis [nodejs.org](https://nodejs.org/).

Linux

**Ubuntu / Debian :**

```bash
curl -fsSL https://deb.nodesource.com/setup_24.x | 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).

Windows

**winget** (recommande) :

```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey :**

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

Ou telechargez l'installateur Windows depuis [nodejs.org](https://nodejs.org/).

Utiliser un gestionnaire de versions (nvm, fnm, mise, asdf)

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

fnm — rapide, multiplateforme
nvm — largement utilise sur macOS/Linux
mise — polyglotte (Node, Python, Ruby, etc.)

Exemple avec fnm :

fnm install 24
fnm use 24

Avertissement : Assurez-vous que votre gestionnaire de versions est initialise dans votre fichier de demarrage shell (~/.zshrc ou ~/.bashrc). S’il ne l’est pas, openclaw risque de ne pas etre trouve dans les nouvelles sessions de terminal car le PATH n’inclura pas le repertoire bin de Node.

Depannage

`openclaw: command not found`

Cela signifie presque toujours que le repertoire bin global de npm n’est pas dans votre PATH.

Etape 1 : Trouver votre prefixe npm global

```bash
npm prefix -g
```

Etape 2 : Verifier s’il est dans votre PATH

```bash
echo "$PATH"
```

Cherchez `<npm-prefix>/bin` (macOS/Linux) ou `<npm-prefix>` (Windows) dans la sortie.

Etape 3 : L’ajouter a votre fichier de demarrage shell

  #### macOS / Linux
    Ajoutez a `~/.zshrc` ou `~/.bashrc` :

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

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

  #### Windows
    Ajoutez la sortie de `npm prefix -g` a votre PATH systeme via Parametres → Systeme → Variables d'environnement.

Erreurs de permission sur `npm install -g` (Linux)

Si vous voyez des erreurs EACCES, basculez le prefixe global de npm vers un repertoire inscriptible par l’utilisateur :

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

Ajoutez la ligne export PATH=... a votre ~/.bashrc ou ~/.zshrc pour la rendre permanente.