OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

Node.js

OpenClaw richiede Node 22.19+, Node 23.11+ o Node 24+. Node 24 è il runtime predefinito e consigliato per installazioni, CI e flussi di rilascio; Node 22 rimane supportato tramite il ramo LTS attivo. Lo script di installazione rileva e installa automaticamente Node: usa questa pagina quando vuoi configurare Node autonomamente (versioni, PATH, installazioni globali).

Verifica la versione

bash
node -v

v24.x.x o una versione successiva è l'opzione predefinita consigliata. v22.19.x o una versione successiva è il percorso supportato per Node 22 LTS (esegui l'aggiornamento a Node 24 quando possibile). Le build di Node 23 precedenti alla v23.11.0 non sono supportate. Se Node non è installato o la versione non rientra nell'intervallo supportato, scegli uno dei metodi di installazione seguenti.

Installa Node

macOS

Homebrew (consigliato):

bash
brew install node

In alternativa, scarica il programma di installazione 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

In alternativa, usa un gestore di versioni (vedi sotto).

Windows

winget (consigliato):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

In alternativa, scarica il programma di installazione per Windows da nodejs.org.

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

I gestori di versioni consentono di passare facilmente da una versione di Node all'altra. Opzioni diffuse:

  • fnm - veloce e multipiattaforma
  • nvm - ampiamente utilizzato su macOS/Linux
  • mise - poliglotta (Node, Python, Ruby e così via)

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 è inclusa nel PATH.

  • Trova il prefisso npm globale

    bash
    npm prefix -g

  • Verifica se è incluso nel 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"

    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 Settings → System → Environment Variables.

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

    Se vengono visualizzati errori EACCES, imposta il prefisso globale di npm 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 file ~/.bashrc o ~/.zshrc per rendere permanente la modifica.

    Argomenti correlati

    Was this useful?
    On this page

    On this page