OpenClaw – Guida Completa, Parte 1: Installazione e Primo Avvio

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:

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:

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:

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:

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.

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:

openclaw status

Per fermare o riavviare il gateway manualmente:

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