# Installare OpenClaw in locale o su VPS: guida passo passo > Come installare OpenClaw passo passo: requisiti, differenza tra installazione locale e su VPS, wizard di onboarding e configurazione del daemon. Prima parte della guida completa. - URL: https://mautoblog.com/posts/openclaw-guida-01-installazione/ - Lingua: it - Pubblicato: 2026-02-25 - Aggiornato: 2026-10-16 - Autore: Mauto - Categorie: Intelligenza Artificiale, Sviluppo Software - Tags: OpenClaw, Self-Hosted, JavaScript, Agenti AI - Guida: OpenClaw dalla A alla Z (parte 1) - Traduzione (en): https://mautoblog.com/en/posts/openclaw-complete-guide-installation-part-1/ --- Hai letto il post introduttivo su OpenClaw e hai deciso di provarlo. Bene. In questa prima parte della guida installeremo il gateway, sceglieremo dove farlo girare e faremo il primo avvio. Niente teoria: solo passi concreti. **Cosa imparerai in questo articolo:** - I requisiti minimi per far girare OpenClaw - La differenza tra installazione locale e su VPS (e quale scegliere) - Come installare OpenClaw e superare il wizard di onboarding iniziale - Come mantenerlo attivo come servizio in background --- ## Prerequisiti: Cosa Ti Serve Prima di Iniziare Prima di toccare qualsiasi comando, assicurati di avere: **Software obbligatorio** - **Node.js versione 22 o superiore** — OpenClaw gira su Node. Se non ce l'hai, scaricalo da `nodejs.org` o usa `nvm` per gestire le versioni. - **Almeno una chiave API di un modello linguistico** — La più raccomandata per iniziare è quella di Anthropic (Claude). La trovi su `console.anthropic.com`. Puoi usare anche OpenAI, Google Gemini o modelli locali tramite Ollama. - **npm** — Viene installato automaticamente insieme a Node.js. **Conoscenze minime** - Saper aprire un terminale e digitare comandi - Saper modificare un file di testo (anche con `nano` o qualsiasi editor) - Avere familiarità con il concetto di variabili d'ambiente e file di configurazione JSON Se questi concetti ti sono nuovi, prenditi un'ora per un tutorial base sul terminale prima di continuare. Vale l'investimento. --- ## Prima Decisione: Locale o VPS? Questa è la scelta più importante che farai. Ha implicazioni su sicurezza, costi e comodità. ### Installazione locale (sul tuo computer) **Vantaggi:** Setup immediato, nessun costo aggiuntivo, facile da sperimentare. **Svantaggi:** OpenClaw funziona solo quando il tuo computer è acceso. Se spegni il Mac o il PC, l'agente smette di lavorare. Non adatto per task proattivi H24. **Quando ha senso:** Fase di test e apprendimento. Se vuoi semplicemente capire come funziona prima di investire in un server. ### Installazione su VPS (server cloud) **Vantaggi:** L'agente gira H24, 7 giorni su 7, anche quando dormi. Il tuo computer personale rimane isolato e al sicuro. È la modalità raccomandata per un uso serio. **Svantaggi:** Ha un costo mensile (una VPS entry-level con 2GB di RAM costa tra i 4€ e i 10€/mese su provider come Hetzner, DigitalOcean o Vultr). Richiede qualche passaggio in più per la configurazione iniziale. **Quando ha senso:** Appena decidi di usare OpenClaw per qualcosa di più di un esperimento. La separazione tra il server dell'agente e la tua macchina personale è anche una misura di sicurezza fondamentale. > **Raccomandazione:** Inizia in locale per familiarizzare. Poi, quando sei pronto, migra su VPS. Questa guida copre entrambi gli scenari. --- ## Installazione ### Metodo 1: Script one-liner (il più rapido) Apri il tuo terminale ed esegui: ```bash curl -fsSL https://openclaw.ai/install.sh | bash ``` Lo script scarica OpenClaw, configura l'ambiente e ti prepara per il passo successivo. È il metodo più rapido e gestisce automaticamente le dipendenze. > **Nota sulla sicurezza:** Prima di eseguire qualsiasi script scaricato da internet con `curl | bash`, è buona pratica visitare l'URL dello script nel browser per leggerne il contenuto. È uno step in più, ma è una buona abitudine. ### Metodo 2: Installazione tramite npm (più controllata) Se preferisci un approccio più diretto: ```bash npm install -g openclaw ``` L'opzione `-g` installa il pacchetto globalmente, rendendolo disponibile come comando da qualsiasi cartella del sistema. Verifica che l'installazione sia andata a buon fine: ```bash openclaw --version ``` Dovresti vedere il numero di versione corrente. Se il comando non viene riconosciuto, potrebbe essere necessario riavviare il terminale o aggiungere la cartella dei pacchetti npm globali al tuo `PATH`. --- ## Primo Avvio: Il Wizard di Onboarding OpenClaw include un wizard interattivo che ti guida nella configurazione iniziale. Avvialo con: ```bash openclaw onboard ``` Il wizard ti farà alcune domande fondamentali. Ecco cosa aspettarti: **1. Inserimento della chiave API** Ti verrà chiesto di inserire la chiave API del tuo provider AI preferito. Per Anthropic (Claude), la trovi nella tua dashboard su `console.anthropic.com`. Incollala quando richiesto. **2. Scelta del modello predefinito** Potrai scegliere quale modello usare di default per l'agente. Per iniziare, `claude-haiku` o `claude-sonnet` sono ottime scelte: offrono un buon equilibrio tra capacità e costo. Evita di impostare `claude-opus` come modello predefinito: è potente ma costoso, e usarlo per tutti i task è uno spreco. **3. Configurazione del canale di messaggistica** Il wizard ti offrirà di collegare subito un canale (Telegram è il più semplice per iniziare — lo vedremo in dettaglio nell'articolo 2). Puoi saltare questo step per ora e configurare i canali in seguito. **4. Conferma e primo test** Al termine, il wizard avvierà brevemente il gateway per verificare che tutto funzioni. Se vedi il messaggio di conferma, sei a posto. --- ## Installazione come Servizio (Solo VPS o Uso Continuativo) Se vuoi che OpenClaw rimanga attivo anche dopo aver chiuso la sessione SSH (o il terminale), devi installarlo come **daemon** — un processo in background gestito dal sistema operativo. ```bash openclaw onboard --install-daemon ``` Questo comando registra OpenClaw come servizio di sistema. Da questo momento, il gateway si avvierà automaticamente a ogni riavvio del server, senza che tu debba fare nulla. Per verificare lo stato del servizio: ```bash openclaw status ``` Per fermare o riavviare il gateway manualmente: ```bash openclaw stop openclaw restart ``` --- ## La Dashboard Web: Il Tuo Centro di Controllo Una volta avviato, OpenClaw espone una dashboard web accessibile dal browser. Per default, si trova all'indirizzo: ``` http://127.0.0.1:18789/ ``` Da qui puoi: - Vedere le conversazioni attive con l'agente - Gestire le sessioni dei canali collegati - Controllare i log in tempo reale - Configurare alcune impostazioni senza toccare i file di configurazione manualmente > **Attenzione su VPS:** Se stai usando un server remoto, non esporre la porta 18789 su internet senza protezione. Usa SSH tunneling (`ssh -L 18789:localhost:18789 user@tuo-server`) per accedere alla dashboard in modo sicuro. Nell'articolo 2 vedremo soluzioni più eleganti con Tailscale o Cloudflare. --- ## Dove Sono i File di Configurazione Tutta la configurazione di OpenClaw vive in un unico file JSON: `~/.openclaw/openclaw.json` Puoi aprirlo con qualsiasi editor di testo. Per ora non è necessario modificarlo manualmente — il wizard si è occupato delle impostazioni base. Nell'articolo 2 vedremo come personalizzarlo per la sicurezza e la configurazione dei canali. --- ## Riepilogo e Prossimo Passo A questo punto dovresti avere: - OpenClaw installato e funzionante (in locale o su VPS) - Il wizard di onboarding completato con almeno una chiave API configurata - La dashboard web accessibile dal browser - Facoltativamente: il servizio daemon attivo per il funzionamento H24 Nel prossimo articolo collegheremo OpenClaw a Telegram e WhatsApp, configureremo la allowlist per la sicurezza e vedremo come proteggere il gateway da accessi non autorizzati. --- *Prossimo articolo → [Parte 2: Configurazione dei Canali e Sicurezza](/posts/openclaw-guida-02-canali-sicurezza/)*