OpenClaw è uno strumento locale che consente al tuo agent AI di collegarsi ad app come Telegram o WhatsApp e compiere azioni, per esempio inviare messaggi o gestire attività. Configurarlo è semplice una volta compreso il processo. Questa guida illustra l’installazione su macOS, Linux e Windows.
Panoramica rapida delle opzioni di configurazione di OpenClaw
Scegli la configurazione più adatta alle tue esigenze. Eseguire OpenClaw in locale mantiene tutto sul tuo computer e richiede l’installazione di dipendenze come npm oppure l’uso di uno script automatizzato. Se preferisci evitare la configurazione, piattaforme completamente ospitate come Kimi Claw gestiscono l’ambiente al posto tuo, permettendoti di iniziare subito.
| macOS / Linux | Windows | |
|---|---|---|
| Esecuzione in locale | Comando Terminale in una riga | Comando PowerShell in una riga |
| Tramite npm | Tramite npm | |
| Tramite Homebrew | Tramite WSL2 | |
| Esecuzione online | Soluzione basata su cloud (es. Kimi Claw) | Soluzione basata su cloud (es. Kimi Claw) |
Come installare OpenClaw su macOS e Linux
macOS e Linux condividono lo stesso programma di installazione e gli stessi comandi. Salvo diversa indicazione, queste istruzioni valgono per entrambi i sistemi.
Di seguito trovi una guida rapida alla configurazione. Per una procedura completa passo passo con screenshot, consulta Come installare OpenClaw su macOS.
Metodo 1: usare lo script di installazione con comando singolo
Passaggio 1: esegui lo script di installazione nel Terminale
Esegui lo script di installazione ufficiale per configurare OpenClaw. Lo script verifica se è installato Node.js 22 o una versione successiva. Se manca o è obsoleto, Node.js 24 verrà installato automaticamente. Quindi installa la CLI di OpenClaw e avvia la procedura guidata di onboarding.
Passaggio 2: completa la procedura guidata di onboarding
Segui la procedura guidata di onboarding per configurare l’ambiente del tuo agent, inclusa la selezione di un provider di modelli (es. Kimi API), l’inserimento della tua chiave API, la scelta di un canale e la configurazione delle impostazioni di base.
Passaggio 3: controlla l’installazione
Esegui il comando seguente per verificare la versione di OpenClaw.
Passaggio 4: verifica il gateway e completa la configurazione
Esegui il comando seguente per controllare che il gateway OpenClaw sia attivo.
Il programma di installazione registra anche un LaunchAgent su macOS o un servizio systemd su Linux, così OpenClaw continua a funzionare in background. Quando tutto è configurato, il tuo agent è pronto all’uso. Puoi iniziare a chattare, collegare strumenti o configurare workflow in base alle tue esigenze.
Metodo 2: installare con Homebrew
Passaggio 1: installa o aggiorna Node.js
Usa Homebrew per installare Node.js eseguendo il comando seguente nel Terminale. Se Node.js è già installato, esegui invece il comando di aggiornamento per assicurarti di usare la versione più recente.
Passaggio 2: installa la CLI di OpenClaw
Esegui il comando seguente per installare globalmente la CLI di OpenClaw.
Passaggio 3: esegui l’onboarding e configura il daemon
Esegui il comando seguente per avviare la procedura guidata di onboarding e registrare il daemon in background. Segui la procedura guidata per configurare l’ambiente del tuo agent, inclusa la selezione di un provider di modelli (es. Kimi API), l’inserimento della tua chiave API e il collegamento di un canale di messaggistica. Una volta completata la configurazione, il tuo agent è pronto all’uso. Puoi iniziare a chattare, collegare strumenti o configurare workflow in base alle tue esigenze.
Metodo 3: installare con npm
Passaggio 1: verifica la versione del runtime
Esegui il comando seguente per verificare che sul sistema sia installato Node.js 22.14 o una versione successiva. Se la tua versione è aggiornata, puoi procedere con l’installazione.
Passaggio 2: installa la CLI di OpenClaw
Esegui il comando seguente per installare globalmente la CLI di OpenClaw.
Passaggio 3: esegui l’onboarding e abilita la persistenza
Esegui il comando seguente per avviare la procedura guidata di onboarding e registrare il daemon in background. Segui la procedura guidata per configurare l’ambiente del tuo agent, inclusa la selezione di un provider di modelli (es. Kimi API), l’inserimento della tua chiave API e la scelta di un canale di messaggistica. Una volta completata la configurazione, il tuo agent è pronto. Puoi iniziare a interagire con lui, collegare strumenti o creare workflow in base alle tue esigenze.
Note sulla piattaforma: OpenClaw supporta sia i Mac Intel sia quelli Apple Silicon. Se l’installazione viene bloccata da Gatekeeper, puoi consentirla nelle Impostazioni di Sistema, in Privacy e sicurezza.
Come installare OpenClaw su Windows
Windows offre tre modalità principali per installare OpenClaw: il programma di installazione PowerShell per una rapida configurazione nativa, WSL2 per un ambiente Linux completo e npm per l’installazione manuale.
Di seguito trovi una guida rapida alla configurazione. Per una procedura completa passo passo con screenshot, consulta Come installare OpenClaw su Windows.
Metodo 1: usare il programma di installazione PowerShell (Windows nativo)
Passaggio 1: esegui lo script di installazione in PowerShell
Apri PowerShell come amministratore ed esegui lo script ufficiale con comando singolo per installare OpenClaw.
Passaggio 2: completa la procedura guidata di onboarding
Segui i passaggi di onboarding per configurare l’ambiente del tuo agent, inclusa la selezione di un provider di modelli (es. Kimi API), l’inserimento della tua chiave API e la scelta di un canale di messaggistica.
Passaggio 3: verifica l’installazione
Esegui il comando seguente per confermare che OpenClaw sia installato correttamente e che il gateway sia attivo.
Passaggio 4: inizia a usare il tuo agent
Una volta completata la configurazione, il tuo agent è pronto. Puoi iniziare a interagire con lui, collegare strumenti o configurare workflow in base alle tue esigenze.
Metodo 2: installare con WSL2
Passaggio 1: configura l’ambiente Linux
Apri PowerShell come amministratore ed esegui il comando seguente per abilitare e inizializzare WSL2.
Passaggio 2: esegui il programma di installazione in Linux
Apri il terminale Linux ed esegui lo script di installazione standard per installare OpenClaw.
Passaggio 3: completa la procedura guidata di onboarding
Segui i passaggi di onboarding per configurare l’ambiente del tuo agent, inclusa la selezione di un provider di modelli (es. Kimi API), l’inserimento della tua chiave API e la scelta di un canale di messaggistica.
Una volta completata la configurazione, il tuo agent è pronto. Puoi iniziare a interagire con lui, collegare strumenti o configurare workflow in base alle tue esigenze.
Metodo 3: installare con npm su Windows
Passaggio 1: controlla la versione di Node.js
Esegui il comando seguente per verificare che Node.js sia installato e aggiornato.
Passaggio 2: installa la CLI di OpenClaw
Esegui il comando seguente per installare globalmente la CLI di OpenClaw.
Passaggio 3: esegui l’onboarding e abilita la persistenza
Esegui il comando seguente per avviare la procedura guidata di onboarding e registrare il daemon in background.
Segui i passaggi di onboarding per configurare l’ambiente del tuo agent, inclusa la selezione di un provider di modelli (es. Kimi API), l’inserimento della tua chiave API e la scelta di un canale di messaggistica.
Una volta completata la configurazione, il tuo agent è pronto. Puoi iniziare a interagire con lui, collegare strumenti o configurare workflow in base alle tue esigenze.
Come eseguire OpenClaw online con Kimi Claw
I metodi descritti sopra richiedono un terminale, una versione supportata di Node.js e una macchina che resti accesa. Kimi Claw offre un’opzione completamente gestita in hosting, così puoi eseguire OpenClaw senza installare né mantenere un ambiente locale.
Passaggio 1: apri Kimi Claw e crea un’istanza
Vai alla pagina di Kimi Claw e fai clic su Crea per iniziare.
Passaggio 2: conferma il deployment
Conferma il deployment nella finestra pop-up. Kimi Claw configurerà automaticamente il tuo ambiente OpenClaw, inclusi gateway e workspace, senza richiedere alcuna configurazione locale.
Passaggio 3: inizia a usare il tuo workspace
Una volta completato il deployment, il tuo workspace si apre nella dashboard. Puoi iniziare a interagire con il tuo agent, configurare skill, impostare attività pianificate e gestire i file direttamente dal browser.
Funzionalità principali di Kimi Claw
Hosting cloud: Kimi Claw esegue il tuo gateway nel cloud, così il tuo agent resta disponibile anche quando la macchina locale è offline.
Manutenzione automatica: aggiornamenti e patch vengono gestiti in background, senza configurazioni manuali o riavvii necessari.
Funzionalità integrate: include pianificazione delle attività, archiviazione persistente e caricamento dinamico delle skill in base ai tuoi prompt, con accesso fluido da tutti i dispositivi.
Risoluzione degli errori più comuni di installazione di OpenClaw
La maggior parte dei problemi di installazione di OpenClaw rientra in alcune categorie ricorrenti, come configurazione del PATH, dipendenze mancanti o conflitti di porta. Le sezioni seguenti ti aiutano a individuare e risolvere rapidamente i problemi più frequenti su macOS, Windows e Linux.
"openclaw: command not found" dopo l’installazione
OpenClaw non è nel PATH del sistema.
Correzione: aggiungi la directory bin globale di npm al PATH.
Quindi ricarica la shell (es. source ~/.zshrc) oppure riavvia il terminale. Su Windows, aggiungi il percorso alle variabili d’ambiente e riavvia PowerShell.
Errori di build di Sharp su macOS
Di solito accade quando un libvips installato globalmente entra in conflitto con la libreria Sharp.
Correzione: esegui il comando di installazione con questa variabile d’ambiente.
Se compaiono errori node-gyp, installa Xcode Command Line Tools:
OpenClaw non si avvia dopo il riavvio
Il daemon in background non è stato installato durante l’onboarding.
Correzione: esegui di nuovo l’onboarding con il flag del daemon.
Quindi verifica il servizio:
Il gateway non risponde o mostra "0 token utilizzati"
Il processo del gateway potrebbe essersi arrestato oppure l’autenticazione API potrebbe non essere riuscita.
Correzione: riavvia il gateway.
Esegui un controllo dello stato:
Per i log di debug:
Verifica inoltre che la tua chiave API sia valida.
Porta 18789 già in uso
Un altro processo sta usando la porta del gateway di OpenClaw.
Correzione: individua e arresta il processo in conflitto
Quindi riavvia il gateway:
Errori di autorizzazione EACCES
Di solito significa che la directory globale di npm non dispone delle autorizzazioni corrette.
Correzione: aggiorna la proprietà della directory.
Su Windows, esegui PowerShell come amministratore oppure imposta un prefisso npm personalizzato:
Per le configurazioni Docker, correggi le autorizzazioni del volume:
Errore "spawn git ENOENT"
Git non è installato o non è disponibile nel PATH.
Correzione: installa Git da git-scm.com, riavvia il terminale e riprova l’installazione.
systemd non funziona in WSL2
Systemd non è abilitato nella configurazione WSL.
Correzione: modifica
/etc/wsl.confe aggiungi.
Quindi riavvia WSL:
Riapri il terminale Linux e verifica:
Memoria esaurita durante npm install su VPS
Le istanze VPS con poca memoria possono non riuscire a completare l’installazione dei pacchetti.
Correzione: crea un file di swap.
Quindi esegui di nuovo l’installazione.
"Access not configured" durante la connessione alle piattaforme di messaggistica
Il tuo account non è autorizzato da OpenClaw.
Correzione: approva il tuo account usando il codice di pairing.
Verifica inoltre che le credenziali del bot (token, webhook, autorizzazioni) siano configurate correttamente.
Conclusione
Installare OpenClaw è semplice su macOS, Linux e Windows. Puoi usare uno script a riga singola, PowerShell, WSL2 o npm, in base alla tua configurazione. La procedura guidata di onboarding ti accompagna nella scelta del modello, nella configurazione API e nei canali di messaggistica. Se preferisci non gestire un ambiente locale, Kimi Claw offre un’opzione completamente gestita in hosting che ti consente di eseguire OpenClaw direttamente nel cloud.
Domande frequenti
node --version per verificare che la versione soddisfi il requisito minimo.npm install -g openclaw@latest dal terminale. In questo modo aggiorni la CLI all’ultima versione. Puoi anche eseguire di nuovo il programma di installazione con comando singolo, che aggiorna automaticamente l’installazione esistente. OpenClaw supporta anche gli aggiornamenti in-app tramite l’interfaccia Control UI all’indirizzo 127.0.0.1:18789. Dopo l’aggiornamento, riavvia il gateway con openclaw gateway restart per caricare la nuova versione.openclaw gateway status per verificare che il daemon sia attivo. Su Windows, WSL2 con systemd abilitato offre la configurazione always-on più affidabile. Se preferisci non gestire servizi locali, opzioni completamente ospitate come Kimi Claw ti consentono di eseguire OpenClaw in modo continuo nel cloud.