First steps
Primeiros passos
Instale o OpenClaw, execute a integração inicial 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 conversa funcional.
O que você precisa
- Node.js — Node 24 recomendado (Node 22.16+ também é compatível)
- Uma chave de API de um provedor de modelo (Anthropic, OpenAI, Google, etc.) — a integração inicial solicitará isso
Configuração rápida
Instalar o OpenClaw
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
Executar a integração inicial
openclaw onboard --install-daemon
O assistente guia você na escolha de um provedor de modelo, na definição de uma chave de API e na configuração do Gateway. Leva cerca de 2 minutos.
Consulte Integração inicial (CLI) para a referência completa.
Verificar se o Gateway está em execução
openclaw gateway status
Você deve ver o Gateway escutando na porta 18789.
Abrir o painel
openclaw dashboard
Isso abre a interface de controle no seu navegador. Se ela carregar, tudo está funcionando.
Enviar sua primeira mensagem
Digite uma mensagem no chat da interface 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 (apenas um token de bot). Consulte Canais para todas as opções.
Avançado: montar uma build personalizada da interface de controle
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
gerados e index.html.
mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copy your built static files into that directory.
Então 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
Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo e mais.
Controle quem pode enviar mensagens ao seu agente.
Modelos, ferramentas, sandbox e configurações avançadas.
Navegador, exec, busca na web, Skills e Plugins.
Avançado: variáveis de ambiente
Se você executa o OpenClaw como uma conta de serviço ou deseja caminhos personalizados:
OPENCLAW_HOME— diretório inicial para resolução de caminhos internosOPENCLAW_STATE_DIR— substitui o diretório de estadoOPENCLAW_CONFIG_PATH— substitui o caminho do arquivo de configuração
Referência completa: Variáveis de ambiente.