[Questo tutorial si basa sulla documentazione ufficiale: docs.openclaw.ai]
Questo programma riguarda la guida all'installazione e alla configurazione su Windows.
Cos'è OpenClaw?
OpenClaw è un gateway AI open source, ospitato autonomamente, che collega le principali app di messaggistica - WhatsApp,
Telegram, Discord, iMessage e altre - agli agenti AI per la programmazione. Basta eseguire un unico processo Gateway
sul proprio computer o server, che funge da ponte tra le app di messaggistica e un
assistente AI sempre disponibile. I tuoi dati rimangono interamente sotto il tuo controllo.
Caratteristiche principali:
• Hosting autonomo: funziona sul tuo hardware, secondo le tue regole;
• Multicanale: un solo Gateway gestisce contemporaneamente WhatsApp, Telegram, Discord e altri servizi;
• Progettato per gli agenti: creato per agenti di programmazione con uso di strumenti, sessioni, memoria e instradamento multiagente;
• Open source: con licenza MIT e sviluppato dalla comunità;
Requisiti di sistema
Prima di iniziare, verifica che il tuo ambiente soddisfi i seguenti requisiti:
Passaggio 1: installa OpenClaw
OpenClaw offre un programma di installazione ufficiale eseguibile con un solo comando che rileva automaticamente il sistema operativo, installa Node.js se necessario, installa OpenClaw e avvia la procedura guidata di configurazione iniziale...
Apri PowerShell ed esegui il seguente comando:
Lo script gestisce tutto: il rilevamento di Node.js, l'installazione di OpenClaw e l'avvio della procedura guidata di configurazione iniziale.
Se Node.js (v22.16+ o v24) è già installato, puoi installare direttamente tramite npm:
Dopo l'installazione, esegui i seguenti comandi per verificare che tutto funzioni:
Il comando doctor verifica automaticamente la presenza di problemi di configurazione e suggerisce le soluzioni.
Passaggio 2: esegui la configurazione iniziale
La procedura guidata onboard è il processo di configurazione interattiva di OpenClaw. Ti guida nella scelta di un fornitore di modelli AI, nell'inserimento della chiave API e nell'installazione del Gateway come servizio in background. L'intero processo richiede circa 2 minuti.
La procedura guidata ti accompagnerà nei seguenti passaggi:
1. Scegli un fornitore di modelli AI (Anthropic, OpenAI, Ollama, ecc.)
2. Inserisci la chiave API corrispondente oppure seleziona un modello Ollama locale
3. Installa il Gateway come servizio di sistema (si avvia automaticamente all'accensione)
Per utilizzare i modelli Ollama locali senza una chiave API, installa prima Ollama e scarica un modello:
4. Scarica e installa Ollama da: https://ollama.com/download
5. Scarica un modello (qui viene mostrato llama3.3 come esempio):
Altri modelli popolari che puoi scaricare:
Esegui quindi onboard e seleziona Ollama dall'elenco dei fornitori. La procedura guidata rileverà automaticamente tutti i modelli disponibili localmente.
Durante la configurazione iniziale, seleziona il fornitore preferito e incolla la chiave API corrispondente quando richiesto. I fornitori supportati includono:
Passaggio 3: avvia e verifica il Gateway
Al termine della configurazione iniziale, esegui il seguente comando per verificare che il Gateway sia in esecuzione:
Se tutto funziona correttamente, l'output mostrerà Runtime: running e RPC probe: ok
Apri il pannello di controllo web di OpenClaw nel browser con:
Il pannello di controllo si apre all'indirizzo: http://127.0.0.1:18789/
Se il pannello di controllo si carica e puoi inviare un messaggio e ricevere una risposta dall'AI, la configurazione è completa.
Gestione del Gateway
Comandi comuni per le operazioni quotidiane del Gateway:
Risoluzione dei problemi
Risorse
• Documentazione ufficiale: https://docs.openclaw.ai
• Repository GitHub: https://github.com/openclaw/openclaw
• Comunità Discord: https://discord.com/invite/clawd
• Libreria dei modelli Ollama: https://ollama.com/library
• Guida alla piattaforma Windows: https://docs.openclaw.ai/platforms/windows
• Configurazione dei fornitori: https://docs.openclaw.ai/providers
• Manuale operativo del Gateway: https://docs.openclaw.ai/gateway.