Come installare OpenClaw su Windows

OpenClaw è uno strumento potente per creare workflow AI, ma configurarlo su Windows può disorientare chi è alle prime armi. Questa guida ti accompagna attraverso i principali metodi di installazione, così puoi iniziare rapidamente.

Installazione di OpenClaw su Windows: confronto tra 3 metodi

Prima di passare ai passaggi, ecco una rapida panoramica dei tre modi per installare OpenClaw su Windows. Ogni metodo comporta compromessi diversi in termini di tempo di configurazione, copertura delle funzionalità e requisiti tecnici.

Kimi Claw è uno strumento online che ti permette di eseguire OpenClaw nel browser. Gestisce automaticamente installazione e configurazione, quindi non ti servono Node.js, WSL né la configurazione di una chiave API. Puoi iniziare a usare un agent pronto all’uso in pochi minuti.

Per una configurazione locale con PowerShell o WSL2, scorri fino a Metodo 1 o Metodo 2. Per saltare del tutto l’installazione locale, vai a Metodo 3: Kimi Claw. Se vuoi iniziare più rapidamente, puoi partire subito.

Cosa serve prima di installare OpenClaw localmente su Windows

Se prevedi di installare OpenClaw in locale, assicurati che il sistema soddisfi i requisiti seguenti. Se scegli un’opzione cloud come Kimi Claw, puoi saltare del tutto questa sezione.

Requisiti di sistema

• Windows 10 o Windows 11 (64 bit)

• Almeno 4 GB di RAM (8 GB consigliati per build npm stabili)

• Connessione Internet stabile

• Privilegi di amministratore per la configurazione iniziale se scegli WSL2

• Per OpenClaw WSL2: la virtualizzazione deve essere abilitata in BIOS/UEFI

Software richiesto

• Node.js 22.14 o superiore. OpenClaw richiede un runtime Node.js moderno. Scaricalo da nodejs.org oppure installalo tramite lo script di onboarding.

• Git for Windows (facoltativo ma consigliato). Alcuni pacchetti npm e skill dipendono da Git.

Metodo 1: installare OpenClaw su Windows con PowerShell

Rispetto a WSL2, il metodo PowerShell richiede meno passaggi e nessun ambiente Linux. Un singolo comando scarica OpenClaw, verifica la versione di Node.js e avvia la procedura guidata di onboarding. Questo metodo funziona sia su Windows 10 sia su Windows 11.

Passaggio 1: installa ed esegui OpenClaw

Per impostazione predefinita, Windows limita l’esecuzione degli script per proteggere il sistema. Prima di installare OpenClaw, devi consentire a PowerShell di eseguire script locali usando questo comando di "sblocco di sicurezza":

Quindi esegui il comando seguente:

Dopo aver eseguito il comando, dovresti vedere un output simile allo screenshot qui sotto. Chiudi e riapri PowerShell per aggiornare il PATH di sistema prima di procedere con l’onboarding.

Passaggio 2: conferma l’avviso sui rischi e scegli la modalità di onboarding

Seleziona Yes per accettare il rischio e continuare.

Poi seleziona QuickStart per avviare rapidamente l’onboarding. Potrai modificare le impostazioni in seguito, oppure scegliere Manual per una configurazione completa.

Passaggio 3: configura e autentica il tuo modello AI

1. Seleziona Moonshot AI come provider di modello/autenticazione

1. Autentica e configura il tuo modello AI

Per connettere OpenClaw, attiva la tua Kimi API Key tramite Kimi Open Platform. Anche se una ricarica da 5 $ti dà diritto a un voucher bonus da 5$, consigliamo almeno 20 $ per sbloccare l’accesso Tier 2. In questo modo riduci la latenza e garantisci che il tuo agent OpenClaw gestisca attività complesse e articolate in più passaggi.

1. Crea una chiave Kimi API

Accedi alla sezione API Keys e fai clic su Create API Key. Ricorda di conservare la tua API Key in un luogo sicuro e facilmente accessibile: viene mostrata una sola volta, al momento della creazione.

1. Inserisci la tua API key e seleziona il modello predefinito

Quando la procedura guidata di onboarding te lo chiede, incolla la tua API key univoca nella finestra di PowerShell/Terminale.

Quando ti viene chiesto di scegliere un modello predefinito, seleziona moonshot/kimi-k2.5 (oppure scegli "Keep current" se è già evidenziato). Questo modello offre il miglior equilibrio tra velocità e capacità di ragionamento per attività agentiche.

Passaggio 4: seleziona il canale

Scegli l’app che vuoi collegare al tuo OpenClaw. Se non sai quale scegliere, salta pure questo passaggio.

Passaggio 5: configura le prestazioni

Fai clic su Yes per configurare, oppure su No per saltare.

Passaggio 6: abilita gli Hooks

Scegli un metodo per chattare con il tuo bot, poi attendi che venga avviato.

Passaggio 7: esegui OpenClaw

Completati tutti i passaggi precedenti, goditi il tuo OpenClaw.

Metodo 2: installare OpenClaw su Windows con WSL2

La configurazione OpenClaw WSL2 offre un ambiente Linux completo dentro Windows ed è il metodo ufficialmente consigliato per eseguire OpenClaw. Consente di accedere all’intero set di funzionalità, inclusa la gestione dei daemon systemd, gli script shell nativi e build npm più fluide. Se prevedi di usare OpenClaw su Windows per flussi di lavoro quotidiani o sviluppo, OpenClaw WSL è la scelta migliore.

Passaggio 1: abilita WSL2 per OpenClaw su Windows 11/10

Apri PowerShell come Administrator ed esegui:

Questo comando abilita WSL, scarica Ubuntu e lo installa. Al termine del processo, riavvia il computer. Al riavvio di Windows, Ubuntu si aprirà e ti chiederà di creare un nome utente e una password.

Se hai già installato WSL, verifica con:

Passaggio 2: configura WSL2 per systemd

OpenClaw viene eseguito come servizio in background tramite systemd. Abilitalo nella configurazione WSL:

Poi riavvia WSL da PowerShell:

Riapri il terminale Ubuntu e verifica che systemd sia in esecuzione:

L’output dovrebbe mostrare systemd. Se invece mostra init, ricontrolla il file /etc/wsl.conf.

Passaggio 3: installa Node.js 22.14+

OpenClaw richiede Node.js 22.14 o versioni successive. Installalo dal repository NodeSource:

Verifica l’installazione:

Passaggio 4: installa OpenClaw tramite npm

Una volta pronto Node.js, installa OpenClaw globalmente:

In alternativa, usa lo script di installazione ufficiale:

Verifica l’installazione:

Passaggio 5: completa la configurazione di OpenClaw su Windows tramite onboarding

Esegui la procedura guidata di onboarding usando il flag daemon per configurare OpenClaw come servizio systemd:

La procedura guidata ti accompagnerà in queste operazioni:

• Selezione del provider LLM e inserimento della API key

• Scelta di un modello predefinito

• Configurazione dei canali di messaggistica (opzionale)

• Installazione del gateway come servizio in background

Dopo l’onboarding, abilita la persistenza del servizio, così OpenClaw si avvierà automaticamente all’avvio di WSL:

Il gateway è il servizio in background principale che gestisce tutte le operazioni di OpenClaw, incluse le richieste degli agent, la messaggistica e l’esecuzione dei modelli. Verificare che sia in esecuzione conferma che l’installazione di OpenClaw è completa e pronta all’uso, ed evita errori nei passaggi successivi.

Esegui il comando seguente nel terminale PowerShell o WSL per controllarne lo stato:

Metodo 3: eseguire OpenClaw su Windows con Kimi Claw (nessuna configurazione richiesta)

Se gestire Node.js, WSL e le API key ti sembra più complicato del necessario, Kimi Claw offre un modo più semplice per eseguire OpenClaw. Ti consente di usare OpenClaw direttamente nel browser, senza installazione locale né configurazione manuale. Per iniziare, segui questi passaggi:

Passaggio 1: apri Kimi Claw e crea un’istanza

Vai alla pagina di Kimi Claw e fai clic su Create per iniziare.

Passaggio 2: avvia il deployment

Conferma il deployment nel pop-up. Kimi Claw configura il tuo ambiente OpenClaw in circa due minuti, inclusi gateway, workspace e strumenti. Non servono comandi né configurazioni manuali.

Passaggio 3: lavora nel tuo workspace

Al termine del deployment, il tuo workspace si apre nella dashboard. Puoi iniziare a chattare con il tuo agent AI, configurare skill, programmare attività e gestire file, tutto dal browser.

Cosa ottieni con Kimi Claw

• Zero configurazione: non serve gestire Node.js, WSL o API key

• 40 GB di spazio cloud: salva report, dataset e file generati che restano disponibili tra una sessione e l’altra

• Memoria persistente: il tuo agent AI ricorda interazioni passate, preferenze e contesto

• Oltre 5.000 skill ClawHub: accedi subito a skill di automazione, ricerca, coding e analisi

• Automazione delle attività pianificate: configura attività ricorrenti come report giornalieri, promemoria e monitoraggio

• Funziona da qualsiasi dispositivo: accedi al tuo agent OpenClaw da qualunque browser su Windows, Mac o mobile

Firewall di Windows e impostazioni di sicurezza per OpenClaw

Kimi Claw gestisce automaticamente sicurezza e rete sui server cloud. Se preferisci installare OpenClaw in locale con PowerShell o WSL2, dopo l’installazione è consigliabile configurare alcune impostazioni di sicurezza.

• Configurazione di Windows Firewall

Al primo avvio del gateway OpenClaw, Windows Firewall potrebbe chiederti di consentire l’accesso alla rete. Consentilo solo per le reti private. Se usi OpenClaw WSL2, il gateway viene eseguito all’interno dell’ambiente Linux e comunica tramite localhost, quindi di solito non servono regole firewall aggiuntive.

Se Browser Relay o altre funzionalità non riescono a connettersi, verifica che il traffico localhost non venga bloccato da software di sicurezza di terze parti, come antivirus, client VPN o firewall aziendali.

• Messa in sicurezza della Control UI

La Control UI di OpenClaw viene eseguita sulla porta 18789 e offre accesso completo al tuo agent. Non esporre mai questa porta a Internet pubblico. Mantieni il gateway associato a 127.0.0.1 e accedi solo dal tuo computer locale.

Per un accesso remoto sicuro, usa Tailscale per creare un tunnel di rete privato:

In questo modo la porta resta su localhost, pur essendo accessibile tramite la tua rete privata Tailscale.

Errori comuni di installazione di OpenClaw su Windows e come risolverli

Anche seguendo una guida chiara, durante l’installazione possono verificarsi problemi. Di seguito trovi gli errori segnalati più spesso nell’installazione di OpenClaw su Windows e le relative soluzioni.

OpenClaw non viene riconosciuto

• Causa: la directory bin globale di npm non è nel PATH di sistema.

• Soluzione: esegui il comando seguente per trovare il prefisso npm

Aggiungi il percorso restituito alle variabili di ambiente di Windows. Non aggiungere \\bin. Poi chiudi e riapri PowerShell.

Git non trovato durante l’installazione

• Causa: Git for Windows non è installato.

• Soluzione: scarica e installa Git da git-scm.com. Dopo l’installazione, riavvia PowerShell e riprova il programma di installazione di OpenClaw per Windows.

La versione di Node.js è troppo vecchia

• Causa: nel sistema è presente una versione di Node.js precedente che non soddisfa il requisito minimo (v22.14+).

• Soluzione: scarica e installa l’ultima versione LTS da nodejs.org. Se usi OpenClaw WSL2, reinstalla dal repository NodeSource.

Errori di permesso negato

• Causa: PowerShell non dispone di autorizzazioni sufficienti oppure la directory globale di npm non è scrivibile.

• Soluzione: esegui PowerShell come Administrator oppure cambia il prefisso globale di npm impostandolo su una directory scrivibile dall’utente

Il gateway non si avvia

• Causa: Port 18789 è già in uso oppure il file di configurazione è danneggiato.

• Soluzione: verifica la presenza di processi in conflitto e riavvia

WSL2 systemd non funziona

• Causa: nel file /etc/wsl.conf manca la configurazione di systemd.

• Soluzione: verifica che il file contenga le impostazioni corrette

Se l’impostazione manca, aggiungila e riavvia WSL con wsl --shutdown in PowerShell.

Conclusione

L’installazione di OpenClaw su Windows può andare da una semplice configurazione basata su script a un ambiente WSL2 più avanzato, a seconda delle tue esigenze. Se vuoi pieno controllo e massima flessibilità, PowerShell e WSL2 sono opzioni solide. Se preferisci saltare la configurazione e iniziare subito, Kimi Claw ti permette di eseguire OpenClaw nel browser senza installazione locale. Scegli l’approccio più adatto al tuo flusso di lavoro e al tuo livello di confidenza tecnica: sarai pronto a sfruttare al meglio OpenClaw.