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
- macOS
- Linux
- Windows
Homebrew (recommandé) :Vous pouvez également télécharger le programme d’installation pour macOS depuis nodejs.org.
Utiliser un gestionnaire de versions (nvm, fnm, mise, asdf)
Utiliser un gestionnaire de versions (nvm, fnm, mise, asdf)
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
<npm-prefix>/bin (macOS/Linux) ou <npm-prefix> (Windows) dans la sortie.3
L’ajouter au fichier de démarrage de votre shell
- macOS / Linux
- Windows
Ajoutez ceci à Ouvrez ensuite un nouveau terminal (ou exécutez
~/.zshrc ou ~/.bashrc :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 :
export PATH=... à votre fichier ~/.bashrc ou ~/.zshrc pour rendre cette modification permanente.
Voir aussi
- Présentation de l’installation - toutes les méthodes d’installation
- Mise à jour - maintenir OpenClaw à jour
- Bien démarrer - premières étapes après l’installation