Vai al contenuto principale

​
Guida introduttiva

Installa OpenClaw, esegui l’onboarding e chatta con il tuo assistente AI, il 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 — si consiglia Node 24 (è supportato anche Node 22.14+)
  • Una chiave API di un provider di modelli (Anthropic, OpenAI, Google, ecc.) — l’onboarding te la richiederà
Controlla la tua versione di Node con node --version. Utenti Windows: sono supportati sia Windows nativo sia WSL2. WSL2 è più stabile ed è consigliato per l’esperienza completa. 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): Installazione.
2

Esegui l'onboarding

openclaw onboard --install-daemon
La procedura guidata ti accompagna nella scelta di un provider di modelli, nell’impostazione di una chiave API e nella configurazione del Gateway. Richiede circa 2 minuti.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 Control UI nel browser. Se si carica, significa che tutto funziona.
5

Invia il tuo primo messaggio

Digita un messaggio nella chat della Control UI e dovresti ricevere una risposta AI.Vuoi invece chattare dal telefono? Il canale più rapido da configurare è Telegram (serve solo un token bot). Vedi Canali per tutte le opzioni.
Se mantieni una build della dashboard localizzata o personalizzata, imposta gateway.controlUi.root su una directory che contenga le risorse statiche compilate e index.html.
mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copia i file statici compilati in quella directory.
Quindi 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

Collega 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.

Esplora 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.