Guida installazione

Installa OpenClaw

Scegli il metodo che preferisci. Tutti portano allo stesso CLI.

checklist Requisiti di sistema

javascript Node.js

Node.js 22 o superiore (LTS consigliato)

computer OS

Windows 10+, macOS 12+ o Linux (Ubuntu 20.04+, Debian 11+)

memory RAM

2 GB di RAM minimo, 4 GB consigliati

hard_drive Disk

~500 MB di spazio su disco per installazione e dipendenze

extension Optional

Opzionale: Python 3.10+ (per alcune skill), Git (per compilazione dai sorgenti)

wifi Network

Connessione internet necessaria per le chiamate API IA. I modelli locali via Ollama funzionano offline.

Script di una riga che fanno tutto. Consigliato per la maggior parte. Tutto nella documentazione arrow_forward

Windows (PowerShell)

Esegui PowerShell come admin per risultati migliori.

PS> curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd --tag beta && del install.cmd

macOS / Linux

Funziona su macOS e la maggior parte delle distro Linux.

$ curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

verified Verifica l'installazione

Lancia questi comandi per confermare che OpenClaw è installato correttamente.

1
$ openclaw --version

Dovrebbe stampare il numero di versione installata (es. v2026.3.12).

2
$ openclaw doctor

Esegue un check diagnostico del tuo ambiente: versione Node.js, dipendenze, file di configurazione e connettività.

3
$ openclaw onboard

Wizard di setup interattivo che ti guida nella configurazione delle API key, connessione alle piattaforme di chat e configurazione iniziale.

settings Configurazione iniziale

Dopo l'installazione, il wizard di onboarding ti guida nel setup. Ecco cosa fa ogni passaggio.

1

Scegli il tuo provider IA

Seleziona Anthropic (Claude), OpenAI (GPT), Google (Gemini) o un modello locale via Ollama. Puoi cambiare provider in qualsiasi momento nella config.

2

Aggiungi la tua API key

Incolla la tua API key dalla dashboard del provider. Le chiavi sono salvate localmente nel file .env — mai inviate da nessuna parte tranne che al provider IA.

3

Connetti una piattaforma di chat

Collega WhatsApp (scansiona QR code), Telegram (incolla il token del bot da @BotFather), Discord (incolla il token del bot) o qualsiasi altra piattaforma supportata.

4

Invia un messaggio di test

Manda un messaggio a OpenClaw tramite la tua app di chat connessa. Se risponde, sei a posto. Prova: 'Cosa sai fare?'

.env — Tutta la configurazione è salvata in ~/.openclaw/.env. Puoi modificare questo file direttamente per cambiare provider, aggiungere API key o regolare le impostazioni. Vedi docs.openclaw.ai/configuration per il riferimento completo.

system_update_alt Aggiornare OpenClaw

Tieni OpenClaw aggiornato per avere le ultime funzionalità, integrazioni e patch di sicurezza. Come aggiornare e migrare arrow_forward

npm
$ npm update -g openclaw@latest
pnpm
$ pnpm update -g openclaw@latest
Git
$ cd openclaw && git pull && pnpm install && pnpm run build
Docker
$ docker pull openclaw/openclaw:latest && docker restart openclaw

Controlla il changelog su github.com/openclaw/openclaw/releases per le novità di ogni versione.

delete_forever Disinstallare OpenClaw

Se devi rimuovere OpenClaw dal tuo sistema, segui i passaggi corrispondenti al metodo di installazione che hai usato. Come disinstallare passo passo arrow_forward

npm
$ npm uninstall -g openclaw
pnpm
$ pnpm remove -g openclaw
Git (Source)
$ rm -rf ~/openclaw
Docker
$ docker stop openclaw && docker rm openclaw && docker rmi openclaw/openclaw:latest

Rimuovere i dati utente (facoltativo)

Verranno eliminati definitivamente tutte le conversazioni, le skill, la configurazione e le chiavi API. Fai prima un backup di tutto ciò che ti serve.

macOS/Linux $ rm -rf ~/.openclaw
Windows PS> rmdir /s /q %USERPROFILE%\.openclaw

build Troubleshooting

Problemi comuni e come risolverli. Altri consigli per risolvere problemi arrow_forward

Hai bisogno d'aiuto?

Entra nel nostro Discord per supporto all'installazione.

Resta aggiornato

Ricevi news su nuove funzionalità e integrazioni. Niente spam, cancellati quando vuoi.