English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Node.js

OpenClaw richiede Node 22.14 o versione successiva. Node 24 è il runtime predefinito e consigliato per installazioni, CI e workflow di rilascio. Node 22 resta 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).

Controlla la tua versione

node -v

Se stampa v24.x.x o superiore, stai usando l'impostazione predefinita consigliata. Se stampa v22.14.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

macOS

Homebrew (consigliato):

brew install node

Oppure scarica il programma di installazione per macOS da nodejs.org.

Linux

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

Oppure usa un gestore di versioni (vedi sotto).

Windows

winget (consigliato):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

Oppure scarica il programma di installazione per Windows da nodejs.org.

Using a version manager (nvm, fnm, mise, asdf)

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

Risoluzione dei problemi

openclaw: command not found

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

  • Find your global npm prefix

    npm prefix -g

  • Check if it's on your PATH

    echo "$PATH"

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

  • Add it to your shell startup file

    macOS / Linux

    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).

    Windows

    Aggiungi l'output di npm prefix -g al PATH di sistema tramite Impostazioni → Sistema → Variabili d'ambiente.

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

    Se visualizzi 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