English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

First steps

Introdução

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

Configuração rápida

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

  • Execute o onboarding

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

  • Verifique se o Gateway está em execução

    bash
    openclaw gateway status

    Você deve ver o Gateway escutando na porta 18789.

  • Abra o painel

    bash
    openclaw dashboard

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

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

    • Avançado: monte uma build personalizada da Control UI

    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.

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

    Em seguida, 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

    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.
    Avançado: variáveis de ambiente

    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

    Was this useful?
    On this page

    On this page