Vai al contenuto principale
Installa OpenClaw, esegui l’onboarding e chatta con il tuo assistente AI: tutto in circa 5 minuti. Alla fine avrai un Gateway in esecuzione, l’autenticazione configurata e una sessione di chat funzionante.

​
Cosa ti serve

  • Node.js — Node 24 consigliato (supportato anche Node 22.19+)
  • Una chiave API da un fornitore di modelli (Anthropic, OpenAI, Google, ecc.) — l’onboarding te la chiederà
Controlla la tua versione di Node con node --version. Utenti Windows: l’app Hub nativa per Windows è il percorso desktop più semplice. Sono supportati anche il programma di installazione PowerShell e i percorsi Gateway WSL2. Vedi Windows. Devi installare Node? Vedi Configurazione di Node.

​
Configurazione rapida

1

Installa OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash
Processo dello script di installazione
Altri metodi di installazione (Docker, Nix, npm): Installa.
2

Esegui l’onboarding

openclaw onboard --install-daemon
La procedura guidata ti accompagna nella scelta di un fornitore di modelli, nell’impostazione di una chiave API e nella configurazione del Gateway. QuickStart richiede di solito solo pochi minuti, ma accesso al fornitore, abbinamento del canale, installazione del demone, download di rete, Skills o Plugin opzionali possono rendere l’onboarding completo più lungo. Puoi saltare i passaggi opzionali e tornarci più tardi con openclaw configure.Vedi Onboarding (CLI) per il riferimento completo.
3

Verifica che il Gateway sia in esecuzione

openclaw gateway status
Dovresti vedere il Gateway in ascolto sulla porta 18789.
4

Apri la dashboard

openclaw dashboard
Questo apre la UI di controllo nel browser. Se si carica, tutto funziona.
5

Invia il tuo primo messaggio

Digita un messaggio nella chat della UI di controllo e dovresti ricevere una risposta AI.Vuoi invece chattare dal telefono? Il canale più veloce da configurare è Telegram (basta un token bot). Vedi Canali per tutte le opzioni.
Se mantieni una build localizzata o personalizzata della dashboard, punta gateway.controlUi.root a una directory che contiene gli asset statici compilati e index.html.
mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copy your built static files into that directory.
Poi imposta:
{
  "gateway": {
    "controlUi": {
      "enabled": true,
      "root": "$HOME/.openclaw/control-ui-custom"
    }
  }
}
Riavvia il Gateway e riapri la dashboard:
openclaw gateway restart
openclaw dashboard

​
Cosa fare dopo

Connetti un canale

Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo e altro ancora.

Abbinamento e sicurezza

Controlla chi può inviare messaggi al tuo agente.

Configura il Gateway

Modelli, strumenti, sandbox e impostazioni avanzate.

Sfoglia gli strumenti

Browser, exec, ricerca web, Skills e Plugin.
Se esegui OpenClaw come account di servizio o vuoi percorsi personalizzati:
  • OPENCLAW_HOME — directory home per la risoluzione dei percorsi interni
  • OPENCLAW_STATE_DIR — sovrascrive la directory dello stato
  • OPENCLAW_CONFIG_PATH — sovrascrive il percorso del file di configurazione
Riferimento completo: Variabili d’ambiente.

​
Correlati