OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

First steps

Primeiros passos

Instale o OpenClaw, execute a integração inicial e converse com seu assistente de IA em cerca de 5 minutos. Ao final, você terá um Gateway em execução, autenticação configurada e uma sessão de conversa funcionando.

O que você precisa

  • Node.js 22.19+, 23.11+ ou 24+ (24 é a versão padrão recomendada)
  • Uma chave de API de um provedor de modelos (Anthropic, OpenAI, Google etc.) — a integração inicial solicitará essa informação

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 orienta você na escolha de um provedor de modelos, na definição de uma chave de API e na configuração do Gateway. O início rápido geralmente leva apenas alguns minutos, mas o login no provedor, o pareamento de canais, a instalação do daemon, os downloads de rede, as Skills ou os plugins opcionais podem fazer com que a integração inicial completa demore mais. Pule as etapas opcionais e retorne posteriormente com openclaw configure.

    Consulte Integração inicial (CLI) para ver a referência completa.

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

    bash
    openclaw gateway status

    Você deverá ver o Gateway escutando na porta 18789.

  • Abrir o painel

    bash
    openclaw dashboard

    Isso abre a interface de controle no 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.

    Prefere conversar pelo celular? O canal mais rápido de configurar é o Telegram (basta um token de bot). Consulte Canais para ver todas as opções.

    • Avançado: montar uma compilação personalizada da interface de controle

    Se você mantém uma compilação localizada ou personalizada do painel, defina gateway.controlUi.root como um diretório que contenha os arquivos estáticos compilados e o index.html.

    bash
    mkdir -p "$HOME/.openclaw/control-ui-custom"# Copie seus arquivos estáticos compilados para esse diretório.

    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

    Próximas etapas

    Conectar um canal

    Discord, Feishu, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo e outros.
    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, execução, pesquisa na web, Skills e plugins.
    Avançado: variáveis de ambiente

    Se você executar o OpenClaw como uma conta de serviço ou quiser usar 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.

    Relacionado

    Was this useful?
    On this page

    On this page