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.

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.

$ openclaw --version

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

$ openclaw doctor

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

$ 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.

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.

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.

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.

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.

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.

build Troubleshooting

Problemi comuni e come risolverli.

Hai bisogno d'aiuto?

Entra nel nostro Discord per supporto all'installazione.

forum Entra su Discord menu_book Leggi la doc

hub Integrazioni • article Blog • apps Progetti