Vai al contenuto principale

​
Node.js

OpenClaw richiede Node 22.14 o versione successiva. Node 24 è il runtime predefinito e consigliato per installazioni, CI e flussi di rilascio. Node 22 continua a essere supportato tramite il ramo LTS attivo. Lo script di installazione rileverà e installerà Node automaticamente — questa pagina è per quando vuoi configurare Node da solo e assicurarti che tutto sia collegato correttamente (versioni, PATH, installazioni globali).

​
Controlla la tua versione

node -v
Se questo stampa v24.x.x o superiore, stai usando il valore predefinito consigliato. Se stampa v22.14.x o superiore, stai usando il percorso supportato di Node 22 LTS, ma consigliamo comunque di passare a Node 24 quando possibile. Se Node non è installato o la versione è troppo vecchia, scegli uno dei metodi di installazione qui sotto.

​
Installa Node

Homebrew (consigliato):
brew install node
Oppure scarica il programma di installazione per macOS da nodejs.org.
I gestori di versioni ti permettono di passare facilmente da una versione di Node all’altra. Opzioni comuni:
  • fnm — veloce, multipiattaforma
  • nvm — molto 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 tuo prefisso globale npm

npm prefix -g
2

Controlla se è nel tuo PATH

echo "$PATH"
Cerca <npm-prefix>/bin (macOS/Linux) oppure <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"
Quindi apri un nuovo terminale (oppure esegui rehash in zsh / hash -r in bash).

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

Se vedi errori EACCES, cambia 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