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

Guida introduttiva

Installa OmeniaClaw, esegui l'onboarding e chatta con il tuo assistente IA — 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.16+)
  • Una chiave API da un provider di modelli (Anthropic, OpenAI, Google, ecc.) — l'onboarding te la richiederà

Configurazione rapida

  • Installa OmeniaClaw

    macOS / Linux

    bash
    curl -fsSL https://omeniaclaw.com/install.sh | bash

    Processo dello script di installazione

    Windows (PowerShell)

    powershell
    iwr -useb https://omeniaclaw.com/install.ps1 | iex

  • Esegui l'onboarding

    bash
    OmeniaClaw onboard --install-daemon

    La procedura guidata ti accompagna 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

    bash
    OmeniaClaw gateway status

    Dovresti vedere il Gateway in ascolto sulla porta 18789.

  • Apri la dashboard

    bash
    OmeniaClaw dashboard

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

  • Invia il tuo primo messaggio

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

    Vuoi invece chattare dal telefono? Il canale più veloce 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 contiene i tuoi asset statici compilati e index.html.

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

    Poi imposta:

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

    Riavvia il gateway e riapri la dashboard:

    bash
    OmeniaClaw gateway restartOmeniaClaw dashboard

    Cosa fare dopo

    Collega un canale

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

    Controlla chi può inviare messaggi al tuo agent.
    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 OmeniaClaw come account di servizio o vuoi percorsi personalizzati:

    • OmeniaClaw_HOME — directory home per la risoluzione dei percorsi interni
    • OmeniaClaw_STATE_DIR — sovrascrive la directory di stato
    • OmeniaClaw_CONFIG_PATH — sovrascrive il percorso del file di configurazione

    Riferimento completo: Variabili d'ambiente.

    Correlati

    Was this useful?
    On this page

    On this page