First steps
Panoramica dell'avvio guidato
OpenClaw offre due percorsi di configurazione iniziale. 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?
| Configurazione iniziale tramite CLI | Configurazione iniziale tramite app macOS | |
|---|---|---|
| Piattaforme | macOS, Linux, Windows (nativo o WSL2) | Solo macOS |
| Interfaccia | Procedura guidata nel terminale | UI guidata nell'app |
| Ideale per | Server, ambienti headless, pieno controllo | Mac desktop, configurazione visiva |
| Automazione | --non-interactive per gli script |
Solo manuale |
| Comando | openclaw onboard |
Avvia l'app |
La maggior parte degli utenti dovrebbe iniziare con la configurazione iniziale tramite CLI: funziona ovunque e offre il massimo controllo.
Che cosa configura la procedura iniziale
Indipendentemente dal percorso scelto, la configurazione iniziale imposta:
- Provider del modello e autenticazione: chiave API, OAuth o token di configurazione per il provider scelto
- Workspace: directory per i file degli agenti, i template di bootstrap e la memoria
- Gateway: porta, indirizzo di bind, modalità di autenticazione
- Canali (opzionale): canali di chat integrati e inclusi nel bundle come iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, Telegram, WhatsApp e altri
- Daemon (opzionale): servizio in background per avviare automaticamente il Gateway
Configurazione iniziale tramite CLI
Esegui in qualsiasi terminale:
openclaw onboardAggiungi --install-daemon per installare anche il servizio in background in un unico passaggio.
Riferimento completo: Configurazione iniziale (CLI)
Documentazione del comando CLI: openclaw onboard
Configurazione iniziale tramite app macOS
Apri l'app OpenClaw. La procedura guidata al primo avvio ti accompagna negli stessi passaggi con un'interfaccia visiva.
Riferimento completo: Configurazione iniziale (app macOS)
Provider personalizzati o non elencati
Se il tuo provider non è elencato nella configurazione iniziale, 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 modello e alias opzionale
Più endpoint personalizzati possono coesistere: ciascuno ottiene il proprio ID endpoint.