First steps
Visão geral do onboarding
O OpenClaw tem dois caminhos de onboarding. Ambos configuram autenticação, o Gateway e canais de chat opcionais — eles apenas diferem na forma 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) | apenas 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 |
apenas manual |
| Comando | openclaw onboard |
Iniciar o app |
A maioria dos usuários deve começar com o onboarding pela CLI — ele funciona em qualquer lugar e oferece mais controle.
O que o onboarding configura
Independentemente do caminho escolhido, o onboarding configura:
- Provedor de modelo e auth — chave de API, OAuth ou token de setup para o provedor 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 incluídos, 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:
openclaw onboard
Adicione --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 da CLI: openclaw onboard
Onboarding pelo app macOS
Abra o app OpenClaw. O assistente de primeira execução orienta você pelas mesmas etapas com uma interface visual.
Referência completa: Onboarding (App macOS)
Provedores personalizados ou não listados
Se o seu provedor não estiver listado no onboarding, escolha Custom Provider e informe:
- modo de compatibilidade da API (compatível com OpenAI, compatível com Anthropic ou detecção automática)
- Base URL e chave de API
- ID do modelo e alias opcional
Vários endpoints personalizados podem coexistir — cada um recebe seu próprio endpoint ID.