Node.js

OpenClaw richiede Node 22.16 o successivo. Node 24 e 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 rileva e installa Node automaticamente — questa pagina e per quando vuoi configurare Node tu stesso e assicurarti che tutto sia collegato correttamente (versioni, PATH, installazioni globali).

Controlla la tua versione

node -v

Se il risultato e v24.x.x o superiore, sei sul runtime predefinito consigliato. Se il risultato e v22.16.x o superiore, sei sul percorso Node 22 LTS supportato, ma ti consigliamo comunque di passare a Node 24 quando possibile. Se Node non e installato o la versione e troppo vecchia, scegli un metodo di installazione qui sotto.

Installa Node

macOS

**Homebrew** (consigliato):

```bash
brew install node
```

Oppure scarica l'installer macOS da [nodejs.org](https://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 version manager (vedi sotto).

Windows

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

Usare un version manager (nvm, fnm, mise, asdf)

I version manager ti permettono di passare facilmente tra versioni di Node. Opzioni popolari:

fnm — veloce, multipiattaforma
nvm — molto diffuso su macOS/Linux
mise — poliglotta (Node, Python, Ruby, ecc.)

Esempio con fnm:

fnm install 24
fnm use 24

Attenzione: Assicurati che il tuo version manager sia inizializzato nel file di avvio della shell (~/.zshrc o ~/.bashrc). Se non lo e, openclaw potrebbe non essere trovato nelle nuove sessioni del terminale perche il PATH non includera la directory bin di Node.

Risoluzione problemi

`openclaw: command not found`

Quasi sempre significa che la directory dei binari globali di npm non e nel tuo PATH.

Passo 1: Trova il prefisso globale di npm

```bash
npm prefix -g
```

Passo 2: Controlla se e nel tuo PATH

```bash
echo "$PATH"
```

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

Passo 3: 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 (o 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, sposta 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.