Passer au contenu principal
title: “Node.js”---

​
Node.js

La base d’exécution d’OpenClaw est Node 22+. Le script d’installation détectera et installera automatiquement Node — cette page est réservée lorsque vous voulez configurer Node vous-même et vous assurer que tout est bien branché (versions, PATH, installations globales).

​
Vérifiez votre version

node -v
Si cela affiche v22.x.x ou supérieur, vous êtes bon. Si Node n’est pas installé ou que la version est trop ancienne, choisissez une méthode d’installation ci-dessous.

​
Install Node

Homebrew (recommandé) :
brew install node
Ou téléchargez l’installateur macOS depuis nodejs.org.
Les gestionnaires de versions vous permettent de basculer facilement entre les versions de Node. Options populaires :- fnm — fast, cross-platform - nvm — largement utilisé sur macOS/Linux - mise — polygotte (Node, Python, Ruby, etc.)Exemple avec fnm :
fnm install 22
fnm use 22
Assurez-vous que votre gestionnaire de versions est initialisé dans le fichier de démarrage de votre shell (~/.zshrc ou ~/.bashrc). Sinon, openclaw peut ne pas être trouvé dans les nouvelles sessions de terminal, car le PATH n’inclura pas le répertoire bin de Node.

​
Problemes courants

​
openclaw: command not found

Cela signifie presque toujours que le répertoire global npm n’est pas présent dans votre PATH.
1

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

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

Add it to your shell startup file

Ajoutez ceci à ~/.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).

​
Permission errors on npm install -g (Linux)

Si vous voyez des erreurs EACCES, changez 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.