# Como instalar o OpenClaw e conectar o Telegram

Reserve cerca de meia hora para ir de uma máquina recém-configurada a um agente que responde você no Telegram. Os comandos mostrados vêm da documentação oficial, então compare-os com a versão que você instalar.

## O que você precisa

- Um computador ou VPS com macOS, Linux, WSL2 ou Windows
- Node 24.16+ ou Node 26, que o instalador pode adicionar para você
- Uma chave de API ou assinatura de um modelo, ou um modelo local
- Uma conta do Telegram

## Passo a passo

### 1. Escolha uma máquina e crie um bot

Um notebook serve para testar, mas um agente que fica sempre ligado deve rodar em um VPS pequeno ou em um servidor doméstico, e a porta do gateway nunca deve ficar aberta para a internet. No Telegram, envie uma mensagem para @BotFather depois de conferir cuidadosamente o nome de usuário, execute /newbot e copie o token fornecido.

### 2. Instalar o OpenClaw

Execute o instalador oficial para o seu sistema. Ele detecta o sistema operacional, adiciona o Node se estiver faltando, instala o OpenClaw e inicia a configuração inicial.

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

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

### 3. Concluir a configuração inicial e instalar o serviço do gateway

Escolha Quick start para reutilizar o acesso à IA detectado ou Custom setup para configurar todas as opções. Quando a configuração inicial terminar, pare o gateway em execução no primeiro plano e instale-o como serviço em segundo plano para que ele reinicie após uma reinicialização.

```bash
openclaw onboard
# after the quick start, stop the foreground gateway (Ctrl+C), then:
openclaw gateway install
```

### 4. Adicionar o canal do Telegram

Adicione o Telegram como canal usando o token do seu bot. Depois, verifique o status do canal para confirmar que a conexão está funcionando.

```bash
openclaw channels add --channel telegram --token <bot-token>
openclaw channels status --probe
```

### 5. Aprove seu pareamento

Envie qualquer mensagem para o seu bot. Remetentes desconhecidos recebem um código de pareamento em vez de uma resposta. Liste as solicitações pendentes e aprove o seu código em até uma hora.

```bash
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
```

### 6. Faça uma auditoria e atualize

Execute a auditoria de segurança integrada e atualize pelo canal estável. Versões anteriores à 2026.4.22 têm vulnerabilidades críticas conhecidas, então não continue usando uma delas.

```bash
openclaw security audit
openclaw update --channel stable
```

## Primeiras coisas a fazer após a configuração

- Mantenha dmPolicy em pairing para impedir que desconhecidos que encontrem seu bot o utilizem.
- Configure as aprovações de exec para sempre pedir confirmação até confiar na sua configuração.
- Repita regularmente a auditoria de segurança e a atualização.

## Erros comuns

- Expor a porta do gateway em vez de manter gateway.bind no loopback e se conectar por SSH ou Tailscale.
- Instalar muitas skills de terceiros. Trate-as como extensões de navegador e adicione apenas algumas, de fontes em que você confia.
- Esquecer que um agente preso em um loop continua consumindo tokens do modelo.