Passer au contenu principal
OpenClaw nécessite Node 22.19+, Node 23.11+ ou Node 24+. Node 24 est l’environnement d’exécution 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 s’adresse aux cas où vous voulez configurer Node vous-même et vérifier que tout est correctement raccordé (versions, PATH, installations globales).

​
Vérifier votre version

node -v
Si cette commande affiche v24.x.x ou une version supérieure, vous utilisez la valeur par défaut recommandée. Si elle affiche v22.19.x ou une version supérieure, vous êtes sur le chemin Node 22 LTS pris en charge, mais nous recommandons tout de même de passer à Node 24 quand cela vous convient. Les versions de Node 23 antérieures à v23.11.0 ne sont pas prises en charge. Si Node n’est pas installé ou si la version est hors de la plage prise en charge, choisissez une méthode d’installation ci-dessous.

​
Installer Node

Homebrew (recommandé) :
brew install node
Ou téléchargez l’installateur macOS depuis nodejs.org.
Les gestionnaires de versions vous permettent de passer facilement d’une version de Node à une 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
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, 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

Trouver votre préfixe npm global

npm prefix -g
2

Vérifier s’il est dans votre PATH

echo "$PATH"
Cherchez <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"
Ouvrez ensuite un nouveau terminal (ou exécutez rehash dans zsh / hash -r dans bash).

​
Erreurs d’autorisation avec npm install -g (Linux)

Si vous voyez des erreurs EACCES, déplacez le préfixe global de 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.

​
Connexe