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

Install overview

Node.js

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

bash
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

macOS

Homebrew (recommandé) :

bash
brew install node

Ou téléchargez l’installateur 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

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

Windows

winget (recommandé) :

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey :

powershell
choco install nodejs-lts

Ou téléchargez l’installateur Windows depuis nodejs.org.

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

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 :

bash
fnm install 24fnm 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.

  • Trouver votre préfixe npm global

    bash
    npm prefix -g

  • Vérifier s’il est 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 à votre PATH 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éplacez le préfixe global de npm vers un répertoire accessible en écriture par l’utilisateur :

    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 ~/.bashrc ou ~/.zshrc pour rendre ce changement permanent.

    Articles connexes

    Was this useful?