Vai al contenuto principale
OpenClaw richiede Node 22.19+, Node 23.11+ o Node 24+. Node 24 è il runtime predefinito e consigliato per installazioni, CI e workflow di rilascio. Node 22 rimane supportato tramite la linea LTS attiva. Lo script di installazione rileverà e installerà Node automaticamente - questa pagina serve quando vuoi configurare Node manualmente e assicurarti che tutto sia collegato correttamente (versioni, PATH, installazioni globali).

​
Controllare la versione

node -v
Se stampa v24.x.x o superiore, stai usando il valore predefinito consigliato. Se stampa v22.19.x o superiore, stai usando il percorso Node 22 LTS supportato, ma consigliamo comunque di passare a Node 24 quando è comodo. Le versioni di Node 23 precedenti a v23.11.0 non sono supportate. Se Node non è installato o la versione è fuori dall’intervallo supportato, scegli un metodo di installazione qui sotto.

​
Installare Node

Homebrew (consigliato):
brew install node
Oppure scarica l’installer per macOS da nodejs.org.
I gestori di versioni ti permettono di passare facilmente da una versione di Node all’altra. Opzioni popolari:
  • fnm - veloce, multipiattaforma
  • nvm - ampiamente usato su macOS/Linux
  • mise - poliglotta (Node, Python, Ruby, ecc.)
Esempio con fnm:
fnm install 24
fnm use 24
Assicurati che il tuo gestore di versioni sia inizializzato nel file di avvio della shell (~/.zshrc o ~/.bashrc). In caso contrario, 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 è nel tuo PATH.
1

Trova il prefisso globale di npm

npm prefix -g
2

Controlla se è nel tuo PATH

echo "$PATH"
Cerca <npm-prefix>/bin (macOS/Linux) o <npm-prefix> (Windows) nell’output.
3

Aggiungilo al file di avvio della shell

Aggiungi a ~/.zshrc o ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
Poi apri un nuovo terminale (oppure esegui rehash in zsh / hash -r in bash).

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

Se vedi errori EACCES, sposta il prefisso globale di npm in una directory scrivibile dall’utente: 
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
Aggiungi la riga export PATH=... al tuo ~/.bashrc o ~/.zshrc per renderla permanente.

​
Correlati