Passer au contenu principal

​
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é) :
brew install node
Ou téléchargez l’installeur macOS depuis 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.
1

Trouver votre préfixe npm global

npm prefix -g
2

Vérifier s’il est dans votre PATH

echo "$PATH"
Recherchez <npm-prefix>/bin (macOS/Linux) ou <npm-prefix> (Windows) dans la sortie.
3

L’ajouter au fichier de démarrage de votre shell

Ajoutez à ~/.zshrc ou ~/.bashrc :
export PATH="$(npm prefix -g)/bin:$PATH"
Puis ouvrez un nouveau terminal (ou exécutez rehash dans zsh / hash -r dans bash).

​
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é