English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Node.js

OpenClaw nécessite Node 22.14 ou une version plus récente. Node 24 est l’environnement d’exécution 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 vérifier que tout est correctement relié (versions, PATH, installations globales).

Vérifier votre version

node -v

Si cette commande affiche v24.x.x ou une version supérieure, vous utilisez la version par défaut recommandée. Si elle affiche v22.14.x ou une version supérieure, vous utilisez le chemin Node 22 LTS pris en charge, mais nous recommandons tout de même de passer à Node 24 lorsque cela est pratique. Si Node n’est pas installé ou si la version est trop ancienne, choisissez une méthode d’installation ci-dessous.

Installer Node

macOS

Homebrew (recommandé) :

brew install node

Ou téléchargez le programme d’installation macOS depuis nodejs.org.

Linux

Ubuntu / Debian :

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

Fedora / RHEL :

sudo dnf install nodejs

Ou utilisez un gestionnaire de versions (voir ci-dessous).

Windows

winget (recommandé) :

winget install OpenJS.NodeJS.LTS

Chocolatey :

choco install nodejs-lts

Ou téléchargez le programme d’installation Windows depuis nodejs.org.

Using a version manager (nvm, fnm, mise, asdf)

Les gestionnaires de versions vous permettent de passer facilement d’une version de Node à une autre. Options courantes :

  • fnm - rapide, multiplateforme
  • nvm - largement utilisé sur macOS/Linux
  • mise - polyglotte (Node, Python, Ruby, etc.)

Exemple avec fnm :

fnm install 24
fnm use 24

Dépannage

openclaw: command not found

Cela signifie presque toujours que le répertoire bin global de npm n’est pas dans votre PATH.

  • Find your global npm prefix

    npm prefix -g

  • Check if it's on your PATH

    echo "$PATH"

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

  • Add it to your shell startup file

    macOS / Linux

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

    Windows

    Ajoutez la sortie de npm prefix -g au PATH de votre système via Paramètres → Système → Variables d’environnement.

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

    Si vous voyez des erreurs EACCES, définissez le préfixe global de npm sur 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.

    Liens associés