English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

First steps

Per iniziare

Installa OpenClaw, esegui l'onboarding e chatta con il tuo assistente IA — tutto in circa 5 minuti. Alla fine avrai un Gateway in esecuzione, auth configurata e una sessione di chat funzionante.

Cosa ti serve

  • Node.js — consigliato Node 24 (supportato anche Node 22.14+)
  • Una chiave API di un provider di modelli (Anthropic, OpenAI, Google, ecc.) — l'onboarding te la chiederà

Configurazione rapida

  • Installa OpenClaw

    macOS / Linux

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

    Processo dello script di installazione

    Windows (PowerShell)

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

  • Esegui l'onboarding

    openclaw onboard --install-daemon

    Il wizard ti guida 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.

  • Verifica che il Gateway sia in esecuzione

    openclaw gateway status

    Dovresti vedere il Gateway in ascolto sulla porta 18789.

  • Apri la dashboard

    openclaw dashboard

    Questo apre la Control UI nel tuo browser. Se si carica, significa che tutto funziona.

  • Invia il tuo primo messaggio

    Scrivi un messaggio nella chat della Control UI e dovresti ricevere una risposta dall'IA.

    Vuoi chattare dal telefono invece? Il canale più rapido da configurare è Telegram (serve solo un token bot). Vedi Canali per tutte le opzioni.

    • Avanzato: monta una build personalizzata della Control UI

    Se mantieni una build della dashboard localizzata o personalizzata, punta gateway.controlUi.root a una directory che contenga i tuoi asset statici compilati e index.html.

    mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copia i tuoi file statici compilati in quella 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

    Collega un canale

    Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo e altro.
    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.
    Avanzato: variabili di ambiente

    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 di stato
    • OPENCLAW_CONFIG_PATH — sovrascrive il percorso del file di configurazione

    Riferimento completo: Variabili di ambiente.

    Correlati