OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

First steps

Per iniziare

Installa OpenClaw, esegui la procedura di onboarding e chatta con il tuo assistente IA in circa 5 minuti. Al termine avrai un Gateway in esecuzione, l'autenticazione configurata e una sessione di chat funzionante.

Cosa serve

  • Node.js 22.19+, 23.11+ o 24+ (24 è la versione predefinita consigliata)
  • Una chiave API di un fornitore di modelli (Anthropic, OpenAI, Google, ecc.) — ti verrà richiesta durante l'onboarding

Configurazione rapida

  • Installa OpenClaw

    macOS / Linux

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

    Procedura dello script di installazione

    Windows (PowerShell)

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

  • Esegui l'onboarding

    bash
    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. L'avvio rapido richiede in genere solo pochi minuti, ma l'accesso al fornitore, l'associazione di un canale, l'installazione del demone, i download di rete, le Skills o i Plugin facoltativi possono prolungare l'intera procedura di onboarding. Salta i passaggi facoltativi e completali in seguito con openclaw configure.

    Per la documentazione completa, consulta Onboarding (CLI).

  • Verifica che il Gateway sia in esecuzione

    bash
    openclaw gateway status

    Dovresti vedere il Gateway in ascolto sulla porta 18789.

  • Apri la dashboard

    bash
    openclaw dashboard

    Questo comando apre l'interfaccia di controllo nel browser. Se viene caricata, tutto funziona correttamente.

  • Invia il tuo primo messaggio

    Digita un messaggio nella chat dell'interfaccia di controllo e dovresti ricevere una risposta dall'IA.

    Preferisci chattare dal telefono? Il canale più rapido da configurare è Telegram (serve solo il token di un bot). Consulta Canali per tutte le opzioni.

    • Avanzato: monta una build personalizzata dell'interfaccia di controllo

    Se mantieni una build localizzata o personalizzata della dashboard, imposta gateway.controlUi.root su una directory contenente le risorse statiche generate e index.html.

    bash
    mkdir -p "$HOME/.openclaw/control-ui-custom"# Copia in questa directory i file statici generati.

    Quindi imposta:

    json
    {"gateway": {  "controlUi": {    "enabled": true,    "root": "$HOME/.openclaw/control-ui-custom"  }}}

    Riavvia il Gateway e riapri la dashboard:

    bash
    openclaw gateway restartopenclaw dashboard

    Passaggi successivi

    Collega un canale

    Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo e altri.
    Associazione e sicurezza

    Controlla chi può inviare messaggi al tuo agente.
    Configura il Gateway

    Modelli, strumenti, sandbox e impostazioni avanzate.
    Esplora gli strumenti

    Browser, esecuzione, ricerca sul Web, Skills e Plugin.
    Avanzato: variabili di ambiente

    Se esegui OpenClaw con un account di servizio o desideri percorsi personalizzati:

    • OPENCLAW_HOME — directory home per la risoluzione dei percorsi interni
    • OPENCLAW_STATE_DIR — sostituisce la directory dello stato
    • OPENCLAW_CONFIG_PATH — sostituisce il percorso del file di configurazione

    Documentazione completa: Variabili di ambiente.

    Contenuti correlati

    Was this useful?
    On this page

    On this page