Installare OpenClaw su Windows 11: guida completa da zero con tutti i passaggi reali
Giorgio Sanna••Aggiornato OpenClaw su Windows 11 può essere installato senza particolari complicazioni, ma richiede alcuni passaggi tecnici fondamentali. In questa guida completa ti spiego come installare OpenClaw su Windows partendo da zero.
Negli ultimi mesi l’idea di avere un agente AI locale sempre attivo non è più un concetto sperimentale per sviluppatori avanzati. Sempre più professionisti stanno cercando soluzioni per eseguire sistemi agentici in autonomia, senza dipendere completamente dal cloud.
In questa guida completa ti spiego come installare OpenClaw su Windows 11 partendo da zero, configurando un ambiente dedicato e stabile. Non si tratta di una semplice panoramica teorica, ma di un’installazione reale con tutti i passaggi tecnici, problemi affrontati e soluzioni adottate.
L’obiettivo è creare un agente AI locale Windows in grado di funzionare 24/7, isolato dal computer principale e pronto per essere integrato in workflow professionali.
Cos’è OpenClaw e perché l’AI locale sta diventando strategica
OpenClaw è un sistema agentico basato su Node.js che consente di orchestrare task, automazioni e flussi operativi attraverso un’interfaccia CLI e una dashboard locale. A differenza di un semplice chatbot o di un LLM tradizionale, un sistema agentico può eseguire azioni, gestire stato e coordinare operazioni in modo strutturato.
Negli ultimi anni il modello cloud-centrico ha dominato il mercato dell’intelligenza artificiale. Tuttavia, l’AI locale sta crescendo per tre motivi principali: controllo, privacy e sostenibilità economica. Un agente AI locale Windows consente di mantenere l’infrastruttura sotto il proprio controllo, ridurre costi ricorrenti e personalizzare l’ambiente senza vincoli imposti da servizi esterni.
Se stai valutando come integrare l’intelligenza artificiale nei tuoi processi aziendali, puoi approfondire il servizio Webita AI, dove sviluppiamo soluzioni personalizzate per aziende e professionisti.
Perché creare un nodo AI dedicato su Windows 11
Per questa installazione non ho utilizzato il mio computer principale. Ho scelto un mini PC dedicato, nello specifico un Neo Z100 0dB fanless, proprio per creare un nodo sempre attivo.
La logica è semplice: separare l’ambiente AI dal sistema operativo quotidiano significa evitare conflitti, mantenere stabilità e poter lasciare l’agente operativo in modo continuativo.
Un mini PC per AI locale offre:
- Consumo energetico ridotto
- Rumore quasi nullo
- Possibilità di funzionare 24/7
- Ambiente isolato per test e automazioni
Windows 11 è stato scelto per compatibilità, semplicità di gestione e supporto nativo ai tool necessari.
Download ufficiali necessari per l’installazione
Prima di iniziare l’installazione di OpenClaw su Windows 11, è necessario scaricare i software ufficiali.
Windows 11 ISO ufficiale:
https://www.microsoft.com/software-download/windows11
Node.js versione LTS:
Git per Windows (consigliato per gestione repository):
https://git-scm.com/download/win
Nel mio caso ho preparato la chiavetta Windows partendo da macOS, ed è qui che si presenta il primo ostacolo tecnico.
Creare la chiavetta Windows 11 da Mac: il problema del file install.wim
Quando si crea una USB Windows da Mac, la chiavetta viene normalmente formattata in FAT32. Questo filesystem non permette file singoli superiori a 4GB. L’ISO di Windows 11 contiene un file chiamato install.wim che supera questo limite. Senza intervenire, la chiavetta non risulta correttamente avviabile.
La soluzione è eseguire lo split del file install.wim utilizzando wimlib.
Il comando utilizzato è stato:
wimlib-imagex split /Volumes/CCCOMA_X64FRE_IT-IT_DV9/sources/install.wim /Volumes/WIN11/sources/install.swm 3800
Questo divide il file in più parti compatibili con FAT32. Lo split install.wim Windows 11 è un passaggio fondamentale quando si lavora da macOS.
Una volta completata questa operazione, la chiavetta è risultata correttamente bootable.
Installazione pulita di Windows 11 sul mini PC
Avviando il sistema da USB, ho eseguito un’installazione pulita di Windows 11. Nessun upgrade, nessun file precedente.
Durante la configurazione iniziale il sistema non rilevava il WiFi, situazione comune su mini PC tipo questo. Ho quindi scaricato manualmente i driver WiFi e Bluetooth e li ho installati tramite chiavetta USB.
Una volta completata la configurazione di rete, il sistema era pronto per procedere con l’OpenClaw installazione completa.
Installazione di Node.js e verifica ambiente
OpenClaw funziona tramite Node.js. Dopo aver installato la versione LTS ufficiale, ho verificato il corretto funzionamento con:
node -v
npm -v
In questa fase possono emergere problemi npm Windows, soprattutto legati a percorsi o script bloccati. Ed è qui che entra in gioco il problema più interessante dell’intera procedura.
Il blocco PowerShell e l’ExecutionPolicy
Durante il tentativo di installazione, PowerShell restituiva il messaggio:
“Execution of scripts is disabled on this system”
Questo accade perché PowerShell applica una ExecutionPolicy che può bloccare l’esecuzione di script non firmati.
Ho tentato di modificare le policy con:
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
E successivamente di forzare l’esecuzione con:
powershell -ExecutionPolicy Bypass -File install.ps1
Nonostante ciò, npm continuava a generare errori ENOENT e problemi di esecuzione.
Perché CMD risolve il problema npm su Windows
Il punto chiave è questo: PowerShell utilizza npm.ps1 per eseguire npm. Se la ExecutionPolicy blocca gli script, npm viene bloccato indirettamente. Il Prompt dei Comandi (CMD) invece utilizza npm.cmd, che non passa dalle stesse restrizioni.
Chiudendo PowerShell e aprendo CMD, l’installazione è proseguita senza più blocchi.
Questo passaggio è fondamentale per chiunque stia cercando di installare OpenClaw su Windows 11 e si trovi bloccato da errori legati agli script.
Installazione OpenClaw completa via CMD
Una volta confermato il corretto funzionamento di Node, ho eseguito:
npm install -g openclaw
Terminata l’installazione, il comando:
openclaw
ha restituito l’elenco dei comandi disponibili, confermando che il sistema era correttamente installato.
Configurare OpenClaw in modalità locale
Per creare un vero OpenClaw setup locale, ho configurato il gateway in modalità local.
Prima inizializzazione:
openclaw setup
Impostazione modalità locale:
openclaw config set gateway.mode local
Avvio gateway:
openclaw gateway –allow-unconfigured
Avvio dashboard:
openclaw dashboard
La dashboard è accessibile tramite browser all’indirizzo:
http://127.0.0.1:18789
A questo punto la configurare OpenClaw dashboard è completa e il sistema è operativo.
Architettura di un agente AI locale
Dietro le quinte, OpenClaw utilizza un’architettura basata su Node.js, con un gateway che gestisce comunicazioni, modelli e skills. L’interfaccia CLI permette di controllare il sistema, mentre la dashboard consente una gestione più intuitiva.
Un agente AI locale Windows può orchestrare task, monitorare stato e interagire con API esterne mantenendo il controllo completo sull’ambiente.
Se vuoi comprendere in modo strutturato come funzionano modelli linguistici, automazioni e sistemi agentici, nel Corso AI di Webita trovi una spiegazione che guida da zero: https://webita.eu/it/corso-ai
Installare OpenClaw su Windows 11 richiede attenzione tecnica ma non è complesso se si conoscono i passaggi chiave.
I punti critici sono:
- Split del file install.wim
- Gestione driver WiFi
- Problemi ExecutionPolicy in PowerShell
- Utilizzo strategico di CMD
- Configurazione corretta del gateway
Una volta completata l’installazione, ci si ritrova con un agente AI locale stabile, autonomo e pronto per essere integrato in workflow professionali. Se stai valutando l’implementazione di un agente AI locale nella tua azienda o nel tuo flusso operativo, puoi richiedere una consulenza personalizzata tramite Webita AI.
FAQ – Installare OpenClaw su Windows 11
OpenClaw funziona su Windows 11 Home?
Sì, non è necessario Windows Pro.
Serve una GPU dedicata?
No, può funzionare su CPU. Una GPU migliora le performance in alcuni scenari.
Perché npm non funziona in PowerShell?
Perché PowerShell applica ExecutionPolicy che può bloccare npm.ps1.
Quanta RAM è consigliata?
8GB è il minimo consigliato, 16GB per carichi complessi.
È possibile usare OpenClaw completamente offline?
Sì, in modalità locale può operare senza dipendere dal cloud, salvo modelli esterni.