docs/docs/it/install/node.md

read_when	summary	title	x-i18n
Devi installare Node.js prima di installare OpenClaw Hai installato OpenClaw ma `openclaw` restituisce comando non trovato `npm install -g` fallisce con problemi di permessi o PATH	Installare e configurare Node.js per OpenClaw — requisiti di versione, opzioni di installazione e risoluzione dei problemi del PATH	Node.js	generated_at model provider source_hash source_path workflow 2026-04-24T08:47:13Z gpt-5.4 openai 99c72b917fa8beba136ee6010799c0183cff8b2420b5a1bd256d9155e50f065a install/node.md 15

OpenClaw richiede Node 22.14 o più recente. Node 24 è il runtime predefinito e consigliato per installazioni, CI e workflow di rilascio. Node 22 resta supportato tramite il ramo LTS attivo. Lo script di installazione rileverà e installerà automaticamente Node — questa pagina serve 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 Node 22 LTS, ma consigliamo comunque di passare a Node 24 quando ti è comodo. Se Node non è installato o la versione è troppo vecchia, scegli uno dei metodi di installazione qui sotto.

Installa Node

**Homebrew** (consigliato):

```bash
brew install node
```

Oppure scarica l’installer macOS da [nodejs.org](https://nodejs.org/).

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

**winget** (consigliato):

```powershell
winget install OpenJS.NodeJS.LTS
```

**Chocolatey:**

```powershell
choco install nodejs-lts
```

Oppure scarica l’installer Windows da [nodejs.org](https://nodejs.org/).

I gestori di versioni ti permettono di passare facilmente tra versioni diverse di Node. Opzioni popolari:

• 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`). Se non lo è, `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.

```bash npm prefix -g ``` ```bash echo "$PATH" ```

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

Aggiungi a `~/.zshrc` oppure `~/.bashrc`:

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

    Poi apri un nuovo terminale (oppure esegui `rehash` in zsh / `hash -r` in bash).
  </Tab>
  <Tab title="Windows">
    Aggiungi l’output di `npm prefix -g` al PATH di sistema tramite Impostazioni → Sistema → Variabili d’ambiente.
  </Tab>
</Tabs>

Errori di permesso con npm install -g (Linux)

Se vedi errori EACCES, passa il prefisso globale di npm a 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 oppure ~/.zshrc per renderla permanente.

Correlati

• Panoramica installazione — tutti i metodi di installazione
• Updating — mantenere OpenClaw aggiornato
• Getting Started — primi passi dopo l’installazione