English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

First steps

Per iniziare

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à

Configurazione rapida

  • Installa OpenClaw

    macOS / Linux

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

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

  • 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 apre la UI di controllo nel browser. Se si carica, tutto funziona.

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

    • Avanzato: monta una build personalizzata della UI di controllo

    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.

    bash
    mkdir -p "$HOME/.openclaw/control-ui-custom"# Copy your built static files into that directory.

    Poi imposta:

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

    Riavvia il Gateway e riapri la dashboard:

    bash
    openclaw gateway restartopenclaw 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.
    Avanzato: variabili d’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 dello stato
    • OPENCLAW_CONFIG_PATH — sovrascrive il percorso del file di configurazione

    Riferimento completo: Variabili d’ambiente.

    Correlati

    Was this useful?
    On this page

    On this page