Primeiros Passos

Objetivo: sair do zero e chegar a um chat funcionando com o mínimo de configuração.

Info: Chat mais rápido: abra a Control UI (sem precisar configurar canais). Execute openclaw dashboard e converse pelo navegador, ou acesse http://127.0.0.1:18789/ no host do gateway (a máquina que roda o serviço OpenClaw Gateway). Docs: Dashboard e Control UI.

Pré-requisitos

• Node 24 recomendado (Node 22 LTS, atualmente 22.16+, ainda suportado por compatibilidade)

Dica: Verifique a versão do Node com node --version se tiver dúvida.

Setup rápido (CLI)

Passo 1: Instale o OpenClaw (recomendado)

  #### macOS/Linux
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
    <img

src=“https://cdn.openclaws.io/public/docs/assets/install-script.svg” alt=“Install Script Process” class=“rounded-lg” />

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



> **Nota:** Outros métodos de instalação e requisitos: [Instalação](/docs/install).

Passo 2: Execute o assistente de onboarding

```bash
openclaw onboard --install-daemon
```

O assistente configura autenticação, opções do gateway e canais opcionais.
Veja [Assistente de Onboarding](/docs/start/wizard) para mais detalhes.

Passo 3: Verifique o Gateway

Se você instalou o serviço, ele já deve estar rodando:

```bash
openclaw gateway status
```

Passo 4: Abra a Control UI

```bash
openclaw dashboard
```

Check: Se a Control UI carregar, seu Gateway está pronto para uso.

Verificações e extras opcionais

Útil para testes rápidos ou troubleshooting.

```bash
openclaw gateway --port 18789
```

Requer um canal configurado.

```bash
openclaw message send --target +15555550123 --message "Hello from OpenClaw"
```

Variáveis de ambiente úteis

Se você roda o OpenClaw como service account ou quer locais personalizados para config/estado:

• OPENCLAW_HOME define o diretório home usado para resolução interna de caminhos.
• OPENCLAW_STATE_DIR sobrescreve o diretório de estado.
• OPENCLAW_CONFIG_PATH sobrescreve o caminho do arquivo de configuração.

Referência completa de variáveis de ambiente: Variáveis de ambiente.

Aprofundando

• Assistente de Onboarding (detalhes) — Referência completa do assistente CLI e opções avançadas.
• Onboarding no app macOS — Fluxo de primeira execução no app macOS.

O que você terá

• Um Gateway rodando
• Autenticação configurada
• Acesso à Control UI ou um canal conectado

Próximos passos

• Segurança de DMs e aprovações: Pareamento
• Conectar mais canais: Canais
• Workflows avançados e instalação a partir do código-fonte: Setup