Vai al contenuto principale

Panoramica dell’onboarding

OpenClaw ha due percorsi di onboarding. Entrambi configurano l’autenticazione, il Gateway e i canali di chat opzionali — differiscono solo nel modo in cui interagisci con la configurazione.

Quale percorso dovrei usare?

Onboarding CLIOnboarding dell’app macOS
PiattaformemacOS, Linux, Windows (nativo o WSL2)Solo macOS
InterfacciaProcedura guidata nel terminaleInterfaccia guidata nell’app
Ideale perServer, ambienti headless, controllo completoMac desktop, configurazione visiva
Automazione--non-interactive per gli scriptSolo manuale
Comandoopenclaw onboardAvvia l’app
La maggior parte degli utenti dovrebbe iniziare con l’onboarding CLI — funziona ovunque e ti offre il massimo controllo.

Cosa configura l’onboarding

Indipendentemente dal percorso scelto, l’onboarding configura:
  1. Provider di modelli e autenticazione — chiave API, OAuth o token di configurazione per il provider scelto
  2. Workspace — directory per i file dell’agente, i modelli bootstrap e la memoria
  3. Gateway — porta, indirizzo di bind, modalità di autenticazione
  4. Canali (opzionale) — canali di chat integrati e plugin inclusi come BlueBubbles, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, Telegram, WhatsApp e altri
  5. Daemon (opzionale) — servizio in background in modo che il Gateway si avvii automaticamente

Onboarding CLI

Esegui in qualsiasi terminale:
openclaw onboard
Aggiungi --install-daemon per installare anche il servizio in background in un solo passaggio. Riferimento completo: Onboarding (CLI) Documentazione del comando CLI: openclaw onboard

Onboarding dell’app macOS

Apri l’app OpenClaw. La procedura guidata del primo avvio ti accompagna negli stessi passaggi con un’interfaccia visiva. Riferimento completo: Onboarding (app macOS)

Provider personalizzati o non elencati

Se il tuo provider non è elencato nell’onboarding, scegli Provider personalizzato e inserisci:
  • Modalità di compatibilità API (compatibile con OpenAI, compatibile con Anthropic o rilevamento automatico)
  • URL di base e chiave API
  • ID del modello e alias opzionale
Più endpoint personalizzati possono coesistere — ognuno ottiene il proprio ID endpoint.