Per iniziare

Obiettivo: partire da zero e arrivare a una prima chat funzionante con il minimo sforzo.

Info: Il modo più veloce per chattare: apri la Control UI (nessuna configurazione di canale necessaria). Lancia openclaw dashboard e chatta dal browser, oppure apri http://127.0.0.1:18789/ sull’host del gateway (la macchina su cui gira il servizio OpenClaw). Documentazione: Dashboard e Control UI.

Prerequisiti

• Node 24 raccomandato (Node 22 LTS, attualmente 22.16+, ancora supportato per compatibilità)

Suggerimento: Verifica la tua versione di Node con node --version se hai dubbi.

Setup rapido (CLI)

Passo 1: Installa OpenClaw (consigliato)

  #### macOS/Linux
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
    <img

src=“https://cdn.openclaws.io/public/docs/assets/install-script.svg” alt=“Install Script Process” class=“rounded-lg” />

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



> **Nota:** Altri metodi di installazione e requisiti: [Installazione](/docs/install).

Passo 2: Lancia il wizard di onboarding

```bash
openclaw onboard --install-daemon
```

Il wizard configura autenticazione, impostazioni del gateway e canali opzionali.
Consulta [Wizard di onboarding](/docs/start/wizard) per i dettagli.

Passo 3: Verifica il Gateway

Se hai installato il servizio, dovrebbe essere già in esecuzione:

```bash
openclaw gateway status
```

Passo 4: Apri la Control UI

```bash
openclaw dashboard
```

Check: Se la Control UI si carica, il tuo Gateway è pronto all’uso.

Verifiche opzionali ed extra

Utile per test rapidi o risoluzione dei problemi.

```bash
openclaw gateway --port 18789
```

Richiede un canale configurato.

```bash
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
```

Variabili d’ambiente utili

Se esegui OpenClaw come account di servizio o vuoi percorsi personalizzati per configurazione e stato:

• OPENCLAW_HOME imposta la directory home usata per la risoluzione interna dei percorsi.
• OPENCLAW_STATE_DIR sovrascrive la directory di stato.
• OPENCLAW_CONFIG_PATH sovrascrive il percorso del file di configurazione.

Riferimento completo sulle variabili d’ambiente: Variabili d’ambiente.

Per approfondire

• Wizard di onboarding (dettagli) — Riferimento completo e opzioni avanzate del wizard CLI.
• Onboarding dell’app macOS — Flusso di prima esecuzione per l’app macOS.

Cosa otterrai

• Un Gateway in esecuzione
• Autenticazione configurata
• Accesso alla Control UI o a un canale connesso

Passi successivi

• Sicurezza DM e approvazioni: Pairing
• Connettere altri canali: Canali
• Workflow avanzati e installazione da sorgente: Setup