OpenClaw no Telegram: bot oficial, grupos e automação (guia)

Telegram é o canal mais “amigável para bots”. A integração costuma ser mais estável do que soluções baseadas em sessão web, e funciona bem em grupos.

Pré-requisitos

• terminal com curl (Linux/macOS; no Windows, use WSL ou PowerShell com curl)
• se optar pelo caminho manual (npm -g), use Node.js 22+
• Token de bot do Telegram (via BotFather)
• Chave de API do modelo (Claude/GPT etc.)

Criar o bot (BotFather)

1. No Telegram, abra @BotFather.
2. Envie:

/newbot

3. Escolha nome e username.
4. Copie o token.

Instalar e conectar

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

Escolha Telegram e cole o token.

Alternativa manual (quando você não quiser usar o instalador oficial):

npm install -g openclaw@latest
openclaw onboard --install-daemon

Grupos

Para o bot funcionar bem em grupo, você normalmente precisa:

• adicionar o bot no grupo
• ajustar permissões
• (se necessário) desligar “Group Privacy” no BotFather

Boas práticas

• Defina comandos curtos para rotinas (ex: “resumo”, “agenda”, “status”).
• Separe um chat privado para comandos sensíveis.
• Para produção, rode em VPS.

Próximos passos

• VPS barato e simples: /vps/hostinger/
• Contratar VPS: Hostinger KVM 2
• Caso de uso para devs: /casos-uso/desenvolvedor/
• Templates para Telegram (copiar e colar): /templates/canais/telegram/
• Referência oficial de instalação/onboarding: docs.openclaw.ai

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