Primeiros passos

Objetivo: ir do zero até o primeiro chat funcional com configuração mínima.

Chat mais rápido: abra a Control UI (nenhuma configuração de canal necessária). Execute openclaw dashboard e converse no navegador, ou abra http://127.0.0.1:18789/ no . Docs: Dashboard e Control UI.

Pré-requisitos

Node 22 ou mais recente

Verifique sua versão do Node com node --version se tiver dúvidas.

Início rápido (CLI)

Install OpenClaw (recommended)

macOS/Linux
Windows (PowerShell)

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

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

```
<Note>
Outros métodos de instalação e requisitos: [Instalar](/install).

</Note>
```

Run the onboarding wizard

openclaw onboard --install-daemon

```
O assistente configura autenticação, configurações do gateway e canais opcionais.
Veja [Onboarding Wizard](/start/wizard) para detalhes.
```

Check the Gateway

Se voce instalou o serviço, ele já deve estar em execução:

````
```bash
openclaw gateway status
```
````

Open the Control UI

openclaw dashboard

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

Verificações opcionais e extras

Run the Gateway in the foreground

Útil para testes rápidos ou solução de problemas.

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

Send a test message

Requer um canal configurado.

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

Variáveis de ambiente úteis

Se você executa o OpenClaw como uma conta de serviço ou deseja locais personalizados para config/estado:

OPENCLAW_HOME define o diretório inicial usado para a resolução interna de caminhos.
OPENCLAW_STATE_DIR substitui o diretório de estado.
OPENCLAW_CONFIG_PATH substitui o caminho do arquivo de configuração.

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

Aprofundar

Onboarding Wizard (details)

Referência completa do assistente de CLI e opções avançadas.

macOS app onboarding

Fluxo da primeira execução para o app macOS.

O que voce terá

Um Gateway em execução
Autenticação configurada
Acesso à Control UI ou um canal conectado

Próximos passos

Segurança e aprovações de DM: Pairing
Conectar mais canais: Channels
Fluxos avançados e a partir do código-fonte: Configuração

Início

Visão geral

Conceitos principais