OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

Node.js

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 processus de publication ; Node 22 reste pris en charge par l’intermédiaire de la branche LTS active. Le script d’installation détecte et installe automatiquement Node — utilisez cette page lorsque vous souhaitez configurer Node vous-même (versions, PATH, installations globales).

Vérifier votre version

bash
node -v

v24.x.x ou une version ultérieure est la valeur par défaut recommandée. v22.19.x ou une version ultérieure constitue la voie prise en charge pour Node 22 LTS (passez à Node 24 lorsque cela vous convient). Les versions de Node 23 antérieures à v23.11.0 ne sont pas prises en charge. Si Node est absent ou se trouve en dehors de la plage prise en charge, choisissez une méthode d’installation ci-dessous.

Installer Node

macOS

Homebrew (recommandé) :

bash
brew install node

Vous pouvez également télécharger le programme d’installation pour macOS depuis nodejs.org.

Linux

Ubuntu / Debian :

bash
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejs

Fedora / RHEL :

bash
sudo dnf install nodejs

Vous pouvez également utiliser un gestionnaire de versions (voir ci-dessous).

Windows

winget (recommandé) :

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey :

powershell
choco install nodejs-lts

Vous pouvez également télécharger le programme d’installation pour Windows depuis nodejs.org.

Utiliser un gestionnaire de versions (nvm, fnm, mise, asdf)

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 :

bash
fnm install 24fnm use 24

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.

  • Trouver votre préfixe npm global

    bash
    npm prefix -g

  • Vérifier s’il figure dans votre PATH

    bash
    echo "$PATH"

    Recherchez <npm-prefix>/bin (macOS/Linux) ou <npm-prefix> (Windows) dans la sortie.

  • L’ajouter au fichier de démarrage de votre shell

    macOS / Linux

    Ajoutez ceci à ~/.zshrc ou ~/.bashrc :

    bash
    export PATH="$(npm prefix -g)/bin:$PATH"

    Ouvrez ensuite un nouveau terminal (ou exécutez rehash dans zsh / hash -r dans bash).

    Windows

    Ajoutez la sortie de npm prefix -g au PATH système via Settings → System → Environment Variables.

    • Erreurs d’autorisation lors de npm install -g (Linux)

    Si vous rencontrez des erreurs EACCES, remplacez le préfixe global de npm par un répertoire dans lequel l’utilisateur peut écrire :

    bash
    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 fichier ~/.bashrc ou ~/.zshrc pour rendre cette modification permanente.

    Pages connexes

    Was this useful?
    On this page

    On this page