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 richiede Node 22.22.3+, Node 24.15+ o Node 25.9+. Node 24 è il runtime predefinito e consigliato per installazioni, CI e flussi di rilascio; Node 22 rimane supportato tramite la linea LTS attiva. Node 23 non è supportato. Lo script di installazione rileva e installa Node automaticamente: usare questa pagina quando si desidera configurare Node manualmente (versioni, PATH, installazioni globali).

Verificare la versione

bash
node -v

v24.15.0 o una versione 24.x più recente è l'opzione predefinita consigliata. v22.22.3 o una versione 22.x più recente è il percorso Node 22 LTS supportato; è supportato anche Node v25.9.0+. Node 23 non è supportato. Se Node non è installato o non rientra nell'intervallo supportato, scegliere uno dei metodi di installazione seguenti.

Installare Node

macOS

Homebrew (consigliato):

bash
brew install node

In alternativa, scaricare il programma di installazione per macOS da 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

In alternativa, usare un gestore di versioni (vedere di seguito).

Windows

winget (consigliato):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

In alternativa, scaricare il programma di installazione per Windows da nodejs.org.

Utilizzo di un gestore di versioni (nvm, fnm, mise, asdf)

I gestori di versioni consentono di passare facilmente da una versione di Node all'altra. Opzioni comuni:

  • fnm - veloce e multipiattaforma
  • nvm - ampiamente utilizzato su macOS/Linux
  • mise - poliglotta (Node, Python, Ruby e così via)

Esempio con fnm:

bash
fnm install 24fnm use 24

Risoluzione dei problemi

openclaw: command not found

Questo significa quasi sempre che la directory bin globale di npm non è inclusa nel PATH.

  • Individuare il prefisso globale di npm

    bash
    npm prefix -g

  • Verificare se è incluso nel PATH

    bash
    echo "$PATH"

    Cercare <npm-prefix>/bin (macOS/Linux) o <npm-prefix> (Windows) nell'output.

  • Aggiungerlo al file di avvio della shell

    macOS / Linux

    Aggiungere a ~/.zshrc o ~/.bashrc:

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

    Quindi aprire un nuovo terminale (oppure eseguire rehash in zsh / hash -r in bash).

    Windows

    Aggiungere l'output di npm prefix -g al PATH di sistema tramite Settings → System → Environment Variables.

    • Errori di autorizzazione con npm install -g (Linux)

    Se vengono visualizzati errori EACCES, impostare come prefisso globale di npm una directory in cui l'utente dispone dei permessi di scrittura:

    bash
    mkdir -p "$HOME/.npm-global"npm config set prefix "$HOME/.npm-global"export PATH="$HOME/.npm-global/bin:$PATH"

    Aggiungere la riga export PATH=... al file ~/.bashrc o ~/.zshrc per rendere permanente la modifica.

    Risorse correlate

    Was this useful?
    On this page

    On this page