O WhatsApp é o canal mais usado no Brasil, mas o Telegram é o mais simples de conectar: você cria um bot em um minuto, cola o token e pronto. É um ótimo “primeiro canal” para testar o OpenClaw sem depender de QR code nem de número dedicado.
Referência rápida do canal: /canais/telegram/.
1. Crie o bot no BotFather
No Telegram, abra uma conversa com @BotFather (a conta oficial de criação de bots) e mande:
/newbotSiga as perguntas (nome e username do bot). No final, o BotFather devolve um token parecido com 123456789:AAExxxxxxxxxxxxxxxxxxxxxxxxxx. Guarde esse token — ele é a credencial do bot.
2. Configure o token no OpenClaw
Você conecta o Telegram pelo arquivo de configuração, não por um comando de login. No openclaw.json:
{
channels: {
telegram: {
enabled: true,
botToken: "123456789:AAE...",
dmPolicy: "pairing",
},
},
}dmPolicy: "pairing" é o ajuste de segurança que importa: o bot só conversa com quem você liberar (veja o passo 4). Sem isso, qualquer pessoa que achar o bot pode falar com ele.
Se preferir variável de ambiente (vale para a conta padrão), use:
export TELEGRAM_BOT_TOKEN="123456789:AAE..."Nunca coloque o token em arquivo versionado. Use variável de ambiente ou mantenha o
openclaw.jsonfora do git. Mesmo cuidado das 5 regras de segurança.
3. Suba o gateway
openclaw gatewayO OpenClaw passa a escutar o Telegram por long polling (o padrão — o bot pergunta ao Telegram se há mensagens novas). Você não precisa abrir portas nem configurar webhook para começar.
4. Libere seu acesso (pairing)
Com dmPolicy: "pairing", a primeira vez que você mandar uma DM para o bot ele gera um código de pareamento. No terminal:
# Lista os pedidos de pareamento pendentes
openclaw pairing list telegram
# Aprova o seu (código que aparece na lista)
openclaw pairing approve telegram <CODIGO>Os códigos expiram em 1 hora — se demorar, mande outra DM e repita.
Para descobrir seu ID de usuário (útil para regras de acesso), mande uma DM ao bot e rode openclaw logs --follow, lendo o campo from.id. Alternativa pela API do Telegram:
curl "https://api.telegram.org/bot<SEU_TOKEN>/getUpdates"5. Primeiro teste
Mande uma mensagem simples no chat com o bot:
- “Resuma este chat em 3 linhas.”
- “Escreva um rascunho de resposta e me peça confirmação antes de enviar.”
Se respondeu, está funcionando. Agora dê contexto (regras, tom, limites) para as respostas ficarem consistentes — o mesmo princípio do tutorial do WhatsApp.
Grupos: cuidado redobrado
Dá para usar o bot em grupos (IDs de supergrupo do Telegram são negativos e começam com -100), mas grupo é uma fonte de texto que você não controla. Cada mensagem vira uma instrução potencial para o agente — é o cenário clássico de prompt injection. Se for inevitável, mantenha o agente com ações restritas e leia segurança e privacidade antes.
Problemas comuns
O bot não responde. Confirme que o gateway está rodando (openclaw gateway) e que o botToken está correto. Token errado é o erro número um.
Respondeu “não autorizado” ou ignorou. Com dmPolicy: "pairing", você precisa aprovar seu acesso (passo 4). Verifique openclaw pairing list telegram.
Quero rodar 24/7. Suba o gateway num VPS — veja rodar OpenClaw na Hostinger — e mantenha o painel fechado, acessível só por túnel SSH ou Tailscale.