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

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
Linux
Windows

Homebrew (consigliato):

brew install node

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

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

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

winget (consigliato):

winget install OpenJS.NodeJS.LTS

Chocolatey:

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:

fnm install 24
fnm use 24

Inizializzare il gestore di versioni nel file di avvio della shell (~/.zshrc o ~/.bashrc). Se si salta questo passaggio, openclaw potrebbe non essere trovato nelle nuove sessioni del terminale perché PATH non includerà la directory bin di Node.

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

npm prefix -g

Verificare se è incluso nel PATH

echo "$PATH"

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

Aggiungerlo al file di avvio della shell

macOS / Linux
Windows

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

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

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

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:

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

Panoramica dell’installazione - tutti i metodi di installazione
Aggiornamento - mantenere OpenClaw aggiornato
Guida introduttiva - primi passi dopo l’installazione

Install overview

Maintenance

Containers

Hosting

Advanced setup

Verificare la versione

Installare Node

Risoluzione dei problemi

`openclaw: command not found`

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

Risorse correlate

​Verificare la versione

​Installare Node

​Risoluzione dei problemi

​openclaw: command not found

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

​Risorse correlate

Verificare la versione

Installare Node

Risoluzione dei problemi

`openclaw: command not found`

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

Risorse correlate