Pular para o conteúdo principal

​
Primeiros passos

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, a autenticação configurada e uma sessão de chat funcionando.

​
O que você precisa

  • Node.js — Node 24 recomendado (Node 22.14+ também é compatível)
  • Uma chave de API de um provedor de modelos (Anthropic, OpenAI, Google etc.) — o onboarding vai solicitar
Verifique sua versão do Node com node --version. Usuários do Windows: tanto o Windows nativo quanto o WSL2 são compatíveis. O WSL2 é mais estável e recomendado para a experiência completa. 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. Isso leva cerca de 2 minutos.Consulte Onboarding (CLI) para a referência completa.
3

Verifique se o Gateway está em execução

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

Abra o painel

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

Envie sua primeira mensagem

Digite uma mensagem no chat da UI de controle e você deverá receber uma resposta da IA.Quer conversar pelo telefone em vez disso? O canal mais rápido de configurar é o Telegram (basta 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 assets estáticos compilados e o index.html.
mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copie seus arquivos estáticos compilados para esse diretório.
Depois 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 em seguida

Conectar um canal

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

Pareamento e segurança

Controle quem pode enviar mensagens ao seu agente.

Configurar o Gateway

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

Explorar 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 home 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.