Come installare OpenClaw — Guida completa all'installazione per Windows, Mac e Linux

L'installazione di OpenClaw richiede circa 5 minuti. Avrai bisogno di Node.js 22+, Git e 8 GB di RAM. Il modo più veloce è un singolo comando npm install -g openclaw@latest seguito dalla procedura guidata di configurazione. In alternativa, salta completamente l'installazione con l'hosting gestito di MyClaw.ai.

Cosa ti serve prima di installare OpenClaw

Prima di installare OpenClaw sulla tua macchina, assicurati di avere questi requisiti:

RequisitoMinimoConsigliataRAM8GB16GBArchiviazione10GB20GBNode.jsv22v22+ (ultimo LTS)SOWin 10 (WSL2) / macOS 12 / Ubuntu 20.04Ultima versione stabile

Opzione 1: Salta l'installazione con l'hosting gestito

Non vuoi occuparti dell'installazione? MyClaw.ai offre hosting OpenClaw completamente gestito — la tua istanza è pronta in pochi secondi senza alcuna configurazione:

• Configurazione istantanea — Nessuna installazione, nessuna configurazione, nessun comando da terminale
• Sempre attivo — Disponibilità 24/7 senza tenere il computer acceso
• Aggiornamenti automatici — Sempre con l'ultima versione di OpenClaw

Inizia con MyClaw.ai →

---

Opzione 2: Self-hosting di OpenClaw

Ci sono due modi per il self-hosting: l'installazione globale consigliata (la più semplice) o la compilazione dal codice sorgente (per sviluppatori).

Consigliato: Installazione globale

Questo è il modo più veloce per far funzionare OpenClaw su qualsiasi piattaforma:

npm install -g openclaw@latest
openclaw onboard --install-daemon

La procedura guidata ti accompagna nella configurazione del gateway, workspace, canali e skill. Il flag --install-daemon configura un servizio in background (launchd su macOS, systemd su Linux) affinché OpenClaw funzioni in modo persistente.

Dopo la configurazione, verifica la tua installazione:

openclaw doctor

---

Alternativa: Compilare dal codice sorgente

Se preferisci il pieno controllo o vuoi contribuire a OpenClaw, puoi compilare dal codice sorgente. Segui le guide specifiche per piattaforma qui sotto.

Installare OpenClaw su Windows

WSL2 è fortemente consigliato per eseguire OpenClaw su Windows. Installa prima WSL2, poi segui le istruzioni per Linux qui sotto.

Se preferisci comunque eseguirlo nativamente su Windows:

Passo 1: Installare i prerequisiti

1. Scarica Node.js v22+ (versione LTS)
2. Scarica Git per Windows
3. Installa pnpm — il gestore di pacchetti preferito di OpenClaw
4. Riavvia il terminale dopo l'installazione

Verifica le installazioni:

node --version   # Dovrebbe essere v22 o successivo
git --version
pnpm --version

Passo 2: Clonare il repository di OpenClaw

Apri PowerShell o il Prompt dei comandi ed esegui:

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Passo 3: Installare e compilare

pnpm install
pnpm ui:build
pnpm build

Questo scarica tutti i pacchetti necessari e compila il progetto.

Passo 4: Eseguire la procedura guidata di configurazione

pnpm openclaw onboard --install-daemon

La procedura guidata ti accompagna nella configurazione di OpenClaw, inclusa la configurazione del modello IA, dei canali e del workspace.

Installare OpenClaw su macOS

Passo 1: Installare i prerequisiti

Il modo più semplice è usare Homebrew:

# Installa Homebrew se necessario
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Installa Node.js e Git
brew install node git

# Installa pnpm
brew install pnpm

Passo 2: Clonare e compilare

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Passo 3: Eseguire la procedura guidata di configurazione

pnpm openclaw onboard --install-daemon

Questo configura un servizio launchd affinché OpenClaw venga eseguito automaticamente in background.

Permessi macOS

OpenClaw potrebbe richiedere permessi di accessibilità per la registrazione dello schermo e le funzionalità vocali. Quando richiesto, vai su:

Impostazioni di Sistema > Privacy e Sicurezza > Accessibilità

Aggiungi la tua applicazione terminale alla lista consentita.

Installare OpenClaw su Linux (Ubuntu/Debian)

Passo 1: Installare i prerequisiti

# Aggiorna il gestore dei pacchetti
sudo apt update

# Installa Node.js 22 tramite NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Installa Git
sudo apt install -y git

# Installa pnpm
npm install -g pnpm

Passo 2: Clonare e compilare

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Passo 3: Eseguire la procedura guidata di configurazione

pnpm openclaw onboard --install-daemon

Questo configura un servizio utente systemd affinché OpenClaw funzioni in modo persistente in background.

Risoluzione dei problemi di installazione comuni

"pnpm install" fallisce con errori di permessi

Su Linux/macOS, evita di usare sudo con pnpm o npm. Correggi invece i permessi:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Errore "Versione di Node non supportata"

OpenClaw richiede Node.js 22 o successivo:

node --version

Se la tua versione è precedente, scarica l'ultima da nodejs.org o usa nvm per gestire le versioni:

nvm install 22
nvm use 22

Porta già in uso

Un'altra applicazione sta usando la stessa porta. Puoi:

• Fermare l'applicazione in conflitto
• Specificare una porta diversa: openclaw gateway --port 18790

Dipendenze native mancanti

Su Linux, potresti aver bisogno di strumenti di compilazione aggiuntivi:

sudo apt install build-essential

Eseguire lo strumento diagnostico

OpenClaw include un comando diagnostico integrato che verifica la tua configurazione:

openclaw doctor

Verificare l'installazione

Dopo aver installato OpenClaw, esegui lo strumento diagnostico per confermare che tutto funzioni:

openclaw doctor

Poi testa con un semplice comando agent:

openclaw agent --message "Ciao, stai funzionando?"

Se OpenClaw risponde, l'installazione è completa.

Aggiornare OpenClaw

Per aggiornare la tua installazione di OpenClaw all'ultima versione:

Se installato globalmente:

openclaw update --channel stable

Se compilato dal codice sorgente:

cd openclaw
git pull origin main
pnpm install
pnpm ui:build
pnpm build

Prossimi passi

Ora che OpenClaw è installato:

• Leggi la Guida introduttiva per imparare l'uso di base
• Scopri di più su Cos'è OpenClaw
• Esplora le opzioni di hosting OpenClaw per l'esecuzione 24/7