Skip to main content
OpenClaw nécessite Node 22.22.3+, Node 24.15+ ou Node 25.9+. Node 24 est l’environnement d’exécution par défaut et recommandé pour les installations, l’intégration continue et les processus de publication ; Node 22 reste pris en charge par l’intermédiaire de la version LTS active. Node 23 n’est pas pris en charge. Le script d’installation détecte et installe automatiquement Node — utilisez cette page si vous souhaitez configurer Node vous-même (versions, PATH, installations globales).

Vérifier votre version

v24.15.0 ou une version 24.x plus récente est la version par défaut recommandée. v22.22.3 ou une version 22.x plus récente correspond à la voie Node 22 LTS prise en charge ; Node v25.9.0+ est également pris en charge. Node 23 n’est pas pris en charge. Si Node est absent ou en dehors de la plage prise en charge, choisissez une méthode d’installation ci-dessous.

Installer Node

Homebrew (recommandé) :
Vous pouvez également télécharger le programme d’installation pour macOS depuis nodejs.org.
Les gestionnaires de versions permettent de passer facilement d’une version de Node à une autre. Options courantes :
  • fnm - rapide et multiplateforme
  • nvm - largement utilisé sous macOS/Linux
  • mise - multilangage (Node, Python, Ruby, etc.)
Exemple avec fnm :
Initialisez votre gestionnaire de versions dans le fichier de démarrage de votre shell (~/.zshrc ou ~/.bashrc). Si vous omettez cette étape, openclaw risque de ne pas être trouvé dans les nouvelles sessions de terminal, car le PATH n’inclura pas le répertoire des exécutables de Node.

Résolution des problèmes

openclaw: command not found

Cela signifie presque toujours que le répertoire global des exécutables de npm ne figure pas dans votre PATH.
1

Trouver votre préfixe npm global

2

Vérifier s’il figure dans votre 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 ceci à ~/.zshrc ou ~/.bashrc :
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, remplacez le préfixe global de npm par un répertoire dans lequel l’utilisateur peut écrire :
Ajoutez la ligne export PATH=... à votre fichier ~/.bashrc ou ~/.zshrc pour rendre cette modification permanente.

Voir aussi