docs/docs/fr/install/node.md

read_when	summary	title	x-i18n
Vous devez installer Node.js avant d’installer OpenClaw Vous avez installé OpenClaw mais `openclaw` est introuvable npm install -g échoue avec des problèmes de permissions ou de PATH	Installer et configurer Node.js pour OpenClaw — exigences de version, options d’installation et dépannage PATH	Node.js	generated_at model provider source_hash source_path workflow 2026-04-05T12:46:37Z gpt-5.4 openai 5e880f6132359dba8720638669df2d71cf857d516cbf5df2589ffeed269b5120 install/node.md 15

Node.js

OpenClaw nécessite Node 22.14 ou plus récent. Node 24 est le runtime par défaut et recommandé pour les installations, la CI et les workflows de publication. Node 22 reste pris en charge via la ligne LTS active. Le script d’installation détectera et installera Node automatiquement — cette page est destinée aux cas où vous souhaitez configurer Node vous-même et vous assurer que tout est correctement branché (versions, PATH, installations globales).

Vérifier votre version

node -v

Si cela affiche v24.x.x ou supérieur, vous êtes sur la valeur par défaut recommandée. Si cela affiche v22.14.x ou supérieur, vous êtes sur le chemin pris en charge Node 22 LTS, mais nous recommandons tout de même de passer à Node 24 lorsque cela vous convient. Si Node n’est pas installé ou si la version est trop ancienne, choisissez une méthode d’installation ci-dessous.

Installer Node

**Homebrew** (recommandé) :

```bash
brew install node
```

Ou téléchargez l’installeur macOS depuis [nodejs.org](https://nodejs.org/).

**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).

**winget** (recommandé) :

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

**Chocolatey :**

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

Ou téléchargez l’installeur Windows depuis [nodejs.org](https://nodejs.org/).

Les gestionnaires de versions vous permettent de changer facilement de version de Node. Options populaires :

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

Exemple avec fnm :

fnm install 24
fnm use 24

Assurez-vous que votre gestionnaire de versions est initialisé dans le fichier de démarrage de votre shell (`~/.zshrc` ou `~/.bashrc`). Sinon, `openclaw` peut être introuvable dans les nouvelles sessions de terminal parce que le PATH n’inclura pas le répertoire bin de Node.

Dépannage

openclaw: command not found

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

```bash npm prefix -g ``` ```bash echo "$PATH" ```

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

Ajoutez à `~/.zshrc` ou `~/.bashrc` :

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

    Puis ouvrez un nouveau terminal (ou exécutez `rehash` dans zsh / `hash -r` dans bash).
  </Tab>
  <Tab title="Windows">
    Ajoutez la sortie de `npm prefix -g` à votre PATH système via Paramètres → Système → Variables d’environnement.
  </Tab>
</Tabs>

Erreurs de permissions sur npm install -g (Linux)

Si vous voyez des erreurs 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"

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

Lié

• Vue d’ensemble de l’installation — toutes les méthodes d’installation
• Mise à jour — garder OpenClaw à jour
• Premiers pas — premières étapes après l’installation