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

Install overview

Node.js

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

bash
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

macOS

Homebrew (consigliato):

bash
brew install node

Oppure scarica l’installer per macOS da nodejs.org.

Linux

Ubuntu / Debian:

bash
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejs

Fedora / RHEL:

bash
sudo dnf install nodejs

Oppure usa un gestore di versioni (vedi sotto).

Windows

winget (consigliato):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

Oppure scarica l’installer per Windows da nodejs.org.

Uso di un gestore di versioni (nvm, fnm, mise, asdf)

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:

bash
fnm install 24fnm use 24

Risoluzione dei problemi

openclaw: command not found

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

  • Trova il prefisso globale di npm

    bash
    npm prefix -g

  • Controlla se è nel tuo PATH

    bash
    echo "$PATH"

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

  • Aggiungilo al file di avvio della shell

    macOS / Linux

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

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

    Poi 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 permesso su npm install -g (Linux)

    Se vedi errori EACCES, cambia il prefisso globale di npm impostandolo su una directory scrivibile dall’utente:

    bash
    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

    Was this useful?