Pular para o conteúdo principal
Instale o OpenClaw, execute o onboarding e converse com seu assistente de IA — tudo em cerca de 5 minutos. Ao final, você terá um Gateway em execução, autenticação configurada e uma sessão de chat funcionando.

​
O que você precisa

  • Node.js — Node 24 recomendado (Node 22.19+ também é compatível)
  • Uma chave de API de um provedor de modelo (Anthropic, OpenAI, Google etc.) — o onboarding solicitará isso
Verifique sua versão do Node com node --version. Usuários de Windows: o app nativo Windows Hub é o caminho de desktop mais fácil. O instalador do PowerShell e os caminhos do Gateway via WSL2 também são compatíveis. Consulte Windows. Precisa instalar o Node? Consulte Configuração do Node.

​
Configuração rápida

1

Instale o OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash
Processo do script de instalação
Outros métodos de instalação (Docker, Nix, npm): Instalação.
2

Execute o onboarding

openclaw onboard --install-daemon
O assistente orienta você na escolha de um provedor de modelo, na definição de uma chave de API e na configuração do Gateway. O QuickStart normalmente leva apenas alguns minutos, mas login no provedor, pareamento de canais, instalação do daemon, downloads de rede, Skills ou plugins opcionais podem fazer o onboarding completo levar mais tempo. Você pode pular etapas opcionais e voltar depois com openclaw configure.Consulte Onboarding (CLI) para a referência completa.
3

Verifique se o Gateway está em execução

openclaw gateway status
Você deve ver o Gateway escutando na porta 18789.
4

Abra o painel

openclaw dashboard
Isso abre a Control UI no seu navegador. Se ela carregar, tudo está funcionando.
5

Envie sua primeira mensagem

Digite uma mensagem no chat da Control UI e você deverá receber uma resposta da IA.Quer conversar pelo telefone? O canal mais rápido de configurar é Telegram (apenas um token de bot). Consulte Canais para ver todas as opções.
Se você mantém uma build localizada ou personalizada do painel, aponte gateway.controlUi.root para um diretório que contenha seus ativos estáticos compilados e index.html.
mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copy your built static files into that directory.
Em seguida, defina:
{
  "gateway": {
    "controlUi": {
      "enabled": true,
      "root": "$HOME/.openclaw/control-ui-custom"
    }
  }
}
Reinicie o gateway e reabra o painel:
openclaw gateway restart
openclaw dashboard

​
O que fazer a seguir

Conecte um canal

Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo e mais.

Pareamento e segurança

Controle quem pode enviar mensagens ao seu agente.

Configure o Gateway

Modelos, ferramentas, sandbox e configurações avançadas.

Explore ferramentas

Navegador, exec, pesquisa na web, Skills e plugins.
Se você executa o OpenClaw como uma conta de serviço ou quer caminhos personalizados:
  • OPENCLAW_HOME — diretório inicial para resolução de caminhos internos
  • OPENCLAW_STATE_DIR — substitui o diretório de estado
  • OPENCLAW_CONFIG_PATH — substitui o caminho do arquivo de configuração
Referência completa: Variáveis de ambiente.

​
Relacionados