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

First steps

Introduzione

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.22.3+, 24.15+ o 25.9+ (24 è la versione predefinita consigliata)
  • Una chiave API di un fornitore di modelli (Anthropic, OpenAI, Google e così via) — verrà richiesta durante l'onboarding

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 consente di scegliere un fornitore di modelli, impostare una chiave API e configurare il Gateway. QuickStart richiede in genere solo pochi minuti, ma l'accesso al fornitore, l'associazione del canale, l'installazione del daemon, i download dalla rete, le Skills o i Plugin facoltativi possono prolungare l'onboarding completo. È possibile saltare i passaggi facoltativi e riprenderli in seguito con openclaw configure.

    Consulta Onboarding (CLI) per il riferimento completo.

  • Verifica che il Gateway sia in esecuzione

    bash
    openclaw gateway status

    Il Gateway dovrebbe risultare 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 primo messaggio

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

    Si preferisce chattare dal telefono? Il canale più rapido da configurare è Telegram (è sufficiente un token del bot). Consulta Canali per tutte le opzioni.

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

    Se si gestisce una build della dashboard localizzata o personalizzata, impostare gateway.controlUi.root su una directory contenente gli asset statici compilati e index.html.

    bash
    mkdir -p "$HOME/.openclaw/control-ui-custom"# Copiare i file statici compilati in tale directory.

    Quindi impostare:

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

    Riavviare il Gateway e riaprire 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 all'agente.
    Configura il Gateway

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

    Browser, esecuzione di comandi, ricerca web, Skills e Plugin.
    Avanzato: variabili di ambiente

    Se si esegue OpenClaw con un account di servizio o si desiderano percorsi personalizzati:

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

    Riferimento completo: Variabili di ambiente.

    Contenuti correlati

    Was this useful?
    On this page

    On this page