Visão Geral do Onboarding
O OpenClaw tem dois caminhos de onboarding. Ambos configuram autenticação, o Gateway e canais de chat opcionais — a diferença está apenas em como você interage com a configuração.Qual caminho devo usar?
| Onboarding pela CLI | Onboarding pelo app macOS | |
|---|---|---|
| Plataformas | macOS, Linux, Windows (nativo ou WSL2) | somente macOS |
| Interface | Assistente no terminal | UI guiada no app |
| Melhor para | Servidores, headless, controle total | Mac desktop, configuração visual |
| Automação | --non-interactive para scripts | somente manual |
| Comando | openclaw onboard | Inicie o app |
O que o onboarding configura
Independentemente do caminho escolhido, o onboarding configura:- Provider de modelo e autenticação — chave de API, OAuth ou setup token para o provider escolhido
- Workspace — diretório para arquivos do agente, templates de bootstrap e memória
- Gateway — porta, endereço de bind, modo de autenticação
- Canais (opcional) — canais de chat integrados e empacotados, como BlueBubbles, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, Telegram, WhatsApp e mais
- Daemon (opcional) — serviço em segundo plano para que o Gateway inicie automaticamente
Onboarding pela CLI
Execute em qualquer terminal:--install-daemon para também instalar o serviço em segundo plano em uma única etapa.
Referência completa: Onboarding (CLI)
Documentação do comando CLI: openclaw onboard
Onboarding pelo app macOS
Abra o app OpenClaw. O assistente da primeira execução orienta você pelas mesmas etapas com uma interface visual. Referência completa: Onboarding (App macOS)Providers personalizados ou não listados
Se o seu provider não estiver listado no onboarding, escolha Provider Personalizado e insira:- Modo de compatibilidade da API (compatível com OpenAI, compatível com Anthropic ou detecção automática)
- URL base e chave de API
- ID do modelo e alias opcional