Node.js

Node.js

OpenClaw nécessite Node 22.14 ou une version plus récente. Node 24 est l’environnement d’exécution par défaut et recommandé pour les installations, l’intégration continue 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 connecté (versions, PATH, installations globales).

Vérifiez votre version

node -v

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

Installer Node

macOSLinuxWindows

Homebrew (recommandé) :

brew install node

Ou téléchargez le programme d’installation macOS depuis nodejs.org.

Ubuntu / Debian :

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

Fedora / RHEL :

sudo dnf install nodejs

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

winget (recommandé) :

winget install OpenJS.NodeJS.LTS

Chocolatey :

choco install nodejs-lts

Ou téléchargez le programme d’installation Windows depuis nodejs.org.

Utilisation d'un gestionnaire de versions (nvm, fnm, mise, asdf)

Les gestionnaires de versions vous permettent de passer facilement d’une version de Node à l’autre. 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

Warning

Assurez-vous que votre gestionnaire de versions est initialisé dans votre fichier de démarrage de shell (~/.zshrc ou ~/.bashrc). Sinon, openclaw pourrait ne pas être trouvé dans les nouvelles sessions de terminal car 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.

1. Find your global npm prefix

   npm prefix -g

2. Vérifiez s'il est dans votre PATH

   echo "$PATH"

   Recherchez `

   /bin(macOS/Linux) ou

   ` (Windows) dans la sortie.

3. Ajoutez-le à votre fichier de démarrage de shell

   macOS / LinuxWindows

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

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

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

   Ajoutez la sortie de npm prefix -g à votre variable d’environnement PATH système via Paramètres → Système → Variables d’environnement.

Erreurs de permission sur npm install -g (Linux)

Si vous voyez des erreurs EACCES, modifiez le préfixe global de npm pour pointer 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 rendre la modification permanente.

Connexes

• Vue d’ensemble de l’installation — toutes les méthodes d’installation
• Mise à jour — tenir OpenClaw à jour
• Getting Started — premiers pas après l’installation