Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw richiede Node 22.16 o versioni successive. Node 24 è il runtime predefinito e consigliato per installazioni, CI e flussi di rilascio. Node 22 resta supportato tramite il ramo LTS attivo. Lo script di installazione rileverà e installerà Node automaticamente: questa pagina serve quando vuoi configurare Node autonomamente e assicurarti che tutto sia collegato correttamente (versioni, PATH, installazioni globali).

​
Controlla la tua versione

node -v
Se stampa v24.x.x o superiore, stai usando l’impostazione predefinita consigliata. Se stampa v22.16.x o superiore, stai usando il percorso Node 22 LTS supportato, ma consigliamo comunque di passare a Node 24 quando ti è comodo. Se Node non è installato o la versione è troppo vecchia, scegli un metodo di installazione qui sotto.

​
Installa 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é il 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 permesso su npm install -g (Linux)

Se vedi errori EACCES, cambia il prefisso globale di npm impostandolo su 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