Guida passo-passo

Iniziare con OpenClaw

Da zero al tuo primo messaggio in 5 minuti. Niente prerequisiti assurdi, niente configurazioni infinite. Promesso.

📋

Cosa ti serve

✅

Un computer

Mac, Linux o Windows (WSL2 consigliato). Può essere un laptop, un mini PC, un Raspberry Pi, o un VPS cloud.

✅

Node.js 24+

Node 22.16+ funziona come fallback. Controlla con node --version.

✅

Una API key

Da un provider AI: Anthropic (Claude), OpenAI (GPT), Google (Gemini), o altri. Il wizard di setup te la chiederà.

💡

5 minuti di tempo

Sul serio. L'installazione è un singolo comando.

Installa OpenClaw

🍎 macOS / 🐧 Linux

curl -fsSL https://openclaw.ai/install.sh | bash

🪟 Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

📦 Alternativa: npm

npm install -g openclaw@latest

Lo script di installazione gestisce tutto: download, dipendenze, path. Se preferisci Docker o Nix, guarda la doc ufficiale.

Esegui l'onboarding

openclaw onboard --install-daemon

Il wizard interattivo ti guida in ~2 minuti attraverso:

🧮 Scelta del modello

Claude, GPT-4, Gemini, o altri — scegli il provider e inserisci la API key

🔧 Configurazione Gateway

Porta, binding, sicurezza di base — tutto con default sensati

🔄 Installazione daemon

Il flag --install-daemon fa partire il servizio automaticamente all'avvio

🔐 Token di autenticazione

Genera automaticamente un token sicuro per proteggere il Gateway

Verifica che funziona

openclaw gateway status

Dovresti vedere il Gateway in ascolto sulla porta 18789. Poi apri la dashboard:

openclaw dashboard

Si apre il Control UI nel browser. Scrivi un messaggio e dovresti ricevere una risposta dall'AI. 🎉

Collega un canale di chat

La dashboard funziona, ma il bello è chattare dal telefono. Il canale più veloce da configurare è Telegram:

4.1

Crea un bot Telegram

Vai su @BotFather su Telegram, usa /newbot, scegli nome e username. Copia il token.

4.2

Configura OpenClaw

Aggiungi il token in ~/.openclaw/openclaw.json:

{
  "channels": {
    "telegram": {
      "token": "IL_TUO_TOKEN_BOT"
    }
  }
}

4.3

Riavvia e chatta

openclaw gateway restart — poi scrivi al tuo bot su Telegram. Fatto!

Altri canali: WhatsApp, Discord, iMessage, Signal, e altri 20+.

I tuoi primi use case

OpenClaw è attivo. Ecco cosa puoi provare subito:

🌤️

"Che tempo fa domani?"

L'agente cerca il meteo e ti risponde. Zero configurazione.

📝

"Ricordami di X alle 18"

Imposta reminder via cron o heartbeat.

🔍

"Cercami info su Y"

Ricerca web con riassunto intelligente.

📄

"Riassumimi questo PDF"

Invia un file e l'agente lo analizza.

Man mano aggiungi skills per capacità più avanzate: email, calendario, domotica, GitHub, social media. Vedi come funziona per la lista completa.

💡

Consigli per partire bene

Parti piccolo. Non collegare subito email, calendario e 5 API. Inizia con la chat base, poi aggiungi un'integrazione alla volta.

Leggi la pagina sicurezza. Qui. Sul serio. 5 minuti che ti risparmiano problemi.

Usa un computer dedicato (se puoi). Un Mac Mini, un vecchio laptop, un Raspberry Pi, un VPS da €5/mese. Separare l'agente dal tuo PC principale è la scelta più smart.

Il modello conta. Per la migliore esperienza, usa l'ultimo modello di punta del tuo provider (Claude Sonnet/Opus, GPT-4o, Gemini Pro). I modelli economici funzionano ma sono meno affidabili con gli strumenti.

Chiedi alla community. Se ti blocchi, siamo qui.

🖥️

Su cosa farlo girare?

💻

Il tuo Mac/PC

Va benissimo per iniziare. Funziona solo quando il computer è acceso.

Facile

🍓

Raspberry Pi / Mini PC

Sempre acceso, basso consumo. Perfetto per un assistente 24/7.

Consigliato

☁️

VPS Cloud

Hetzner, DigitalOcean, AWS. Accessibile da ovunque. Da €5/mese.

Pro

Problemi? Dubbi?

La community è qui per aiutarti. E leggi la guida sicurezza prima di collegare account importanti.

🔒 Sicurezza 💬 Community