Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw nécessite Node 22.16 ou version ultérieure. 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 s’adresse aux cas où vous voulez configurer Node vous-même et vous assurer 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 ultérieure, vous utilisez la valeur par défaut recommandée. Si elle affiche v22.16.x ou une version ultérieure, vous utilisez le chemin Node 22 LTS pris en charge, 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’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). Si ce n’est pas le cas, openclaw peut 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

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 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).

​
Erreurs d’autorisation sur 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 rendre ce changement permanent.

​
Articles connexes