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

bash

curl -fsSL https://openclaw.ai/install.sh | bash

Processo do Script de Instalação

Windows (PowerShell)

powershell

iwr -useb https://openclaw.ai/install.ps1 | iex

Executar a integração inicial

bash

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

bash

openclaw gateway status

Você deve ver o Gateway escutando na porta 18789.

Abrir o painel

bash

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.

bash

mkdir -p "$HOME/.openclaw/control-ui-custom"# Copy your built static files into that directory.

Então defina:

json

{"gateway": {  "controlUi": {    "enabled": true,    "root": "$HOME/.openclaw/control-ui-custom"  }}}

Reinicie o Gateway e reabra o painel:

bash

openclaw gateway restartopenclaw dashboard

O que fazer a seguir

Conectar 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.

Configurar o Gateway

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

Explorar ferramentas

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 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

Was this useful?