Skip to main content
OpenClaw dispone dell’onboarding tramite terminale e app macOS. Entrambi configurano prima l’inferenza: rilevano l’accesso esistente all’IA, richiedono un completamento in tempo reale e solo successivamente avviano OpenClaw per configurare gli elementi rimanenti. Un Gateway raggiungibile e configurato, il cui agente predefinito dispone già di un modello configurato, ignora l’onboarding e apre la normale interfaccia utente dell’agente. Il flusso da terminale offre inoltre la procedura guidata classica completa per una configurazione dettagliata.

​
Quale percorso utilizzare?

Per la maggior parte degli utenti è consigliabile iniziare con l’onboarding tramite CLI: funziona ovunque e offre il massimo controllo.

​
Cosa configura l’onboarding

La fase guidata dell’inferenza configura esclusivamente:
  1. Provider del modello e autenticazione — accesso rilevato oppure accesso verificato a un provider, chiave API o token
  2. Inferenza verificata — un completamento reale sul modello effettivo dell’agente predefinito
Dopo il superamento del completamento, OpenClaw può configurare lo spazio di lavoro, il Gateway, il servizio Gateway, i canali, gli agenti, i plugin e altre funzionalità facoltative. La procedura guidata classica della CLI può inoltre configurare:
  1. Canali (facoltativo) — canali di chat integrati e inclusi, come Discord, Feishu, Google Chat, iMessage, Mattermost, Microsoft Teams, Telegram, WhatsApp e altri
  2. Controlli avanzati del Gateway — modalità remota, impostazioni di rete e opzioni del daemon

​
Onboarding tramite CLI

Eseguire in un terminale qualsiasi:
Il flusso guidato rileva l’accesso esistente all’IA, verifica in tempo reale i candidati nell’ordine previsto e, in caso di errore, passa al successivo. Se il rilevamento non produce risultati, mostra prima OpenAI, Anthropic, xAI (Grok), Google e OpenRouter. Altro… contiene i provider rimanenti suddivisi in gruppi, mentre un secondo menu presenta regioni, piani e metodi supportati tramite browser, dispositivo, chiave API o token. Il modello e la credenziale vengono salvati solo dopo un completamento riuscito; successivamente viene avviato OpenClaw per configurare lo spazio di lavoro, il Gateway, i canali, gli agenti, i plugin e altre funzionalità facoltative. Ignora per ora termina il flusso senza avviare OpenClaw. Non è previsto il passaggio alla procedura classica all’interno del flusso; per utilizzare la procedura guidata classica, uscire ed eseguire openclaw onboard --classic. Dopo il superamento dell’inferenza, OpenClaw può affidare la configurazione dei canali a una procedura guidata da terminale con input mascherato. Non apre la configurazione guidata o classica del provider; per modificare il provider del modello o la relativa autenticazione, uscire da OpenClaw ed eseguire openclaw onboard. Utilizzare openclaw onboard --classic per la configurazione dettagliata di modello/autenticazione, canali, skill, Gateway remoto o importazione. L’aggiunta di --install-daemon seleziona inoltre il flusso classico e installa il servizio in background in un solo passaggio. Utilizzare openclaw openclaw per la configurazione e la riparazione conversazionale non relativa all’inferenza. openclaw onboard --modern è un alias di compatibilità che utilizza lo stesso controllo dell’inferenza in tempo reale. Riferimento completo: Onboarding (CLI) Documentazione del comando CLI: openclaw onboard

​
Onboarding tramite app macOS

Aprire l’app OpenClaw. Se il Gateway locale o remoto configurato è raggiungibile e l’agente predefinito dispone già di un modello configurato, l’app ignora l’onboarding e OpenClaw e apre immediatamente la normale interfaccia utente dell’agente. Per un Gateway nuovo o incompleto, il flusso di primo avvio rileva l’accesso esistente all’IA (Claude Code, Codex o chiavi API), verifica in tempo reale l’opzione migliore e la salva solo dopo una risposta reale, passando automaticamente alle alternative e proponendo un passaggio manuale verificato con chiave API quando non viene rilevato nulla. Le credenziali sensibili utilizzano un input mascherato. Dopo il superamento dell’inferenza, OpenClaw si avvia e assiste nella configurazione degli elementi rimanenti. Gemini CLI rimane disponibile per gli agenti normali dopo la configurazione, ma non viene proposto per questo controllo dell’inferenza perché non può imporre il test senza strumenti. Riferimento completo: Onboarding (app macOS)

​
Provider personalizzati o non elencati

Se il provider non è elencato, eseguire openclaw onboard --classic, scegliere Provider personalizzato e immettere:
  • Compatibilità dell’endpoint: compatibile con OpenAI (/chat/completions), compatibile con OpenAI Responses (/responses), compatibile con Anthropic (/messages) oppure sconosciuta (verifica tutte e tre le opzioni e la rileva automaticamente)
  • URL di base e chiave API (la chiave API è facoltativa se l’endpoint non ne richiede una)
  • ID del modello e alias facoltativo del modello
Possono coesistere più endpoint personalizzati: ciascuno dispone di un proprio ID endpoint.

​
Contenuti correlati