First steps

Visão geral da integração

OpenClaw tem dois caminhos de configuração inicial. Ambos configuram autenticação, o Gateway e canais de chat opcionais — eles diferem apenas na forma como você interage com a configuração.

Qual caminho devo usar?

Configuração inicial pela CLI Configuração inicial pelo app macOS
Plataformas macOS, Linux, Windows (nativo ou WSL2) somente macOS
Interface Assistente no terminal UI guiada no app
Ideal para Servidores, headless, controle total Mac desktop, configuração visual
Automação --non-interactive para scripts Somente manual
Comando openclaw onboard Iniciar o app

A maioria dos usuários deve começar com a configuração inicial pela CLI — ela funciona em todos os lugares e dá a você o máximo controle.

O que a configuração inicial configura

Independentemente do caminho escolhido, a configuração inicial define:

  1. Provedor de modelo e autenticação — chave de API, OAuth ou token de configuração para o provedor escolhido
  2. Workspace — diretório para arquivos de agente, modelos de bootstrap e memória
  3. Gateway — porta, endereço de bind, modo de autenticação
  4. Canais (opcional) — canais de chat integrados e incluídos, como iMessage, Discord, Feishu, Google Chat, Mattermost, Microsoft Teams, Telegram, WhatsApp e outros
  5. Serviço em segundo plano (opcional) — serviço em segundo plano para que o Gateway seja iniciado automaticamente

Configuração inicial pela CLI

Execute em qualquer terminal:

bash
openclaw onboard

Adicione --install-daemon para também instalar o serviço em segundo plano em uma única etapa.

Referência completa: Configuração inicial (CLI) Documentação do comando CLI: openclaw onboard

Configuração inicial 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: Configuração inicial (app macOS)

Provedores personalizados ou não listados

Se seu provedor não estiver listado na configuração inicial, escolha Provedor personalizado e insira:

  • Modo de compatibilidade de 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

Vários endpoints personalizados podem coexistir — cada um recebe seu próprio ID de endpoint.

Relacionado

Was this useful?