OpenClaw no Telegram

Telegram é um dos melhores canais para usar o OpenClaw quando você quer um bot separado do seu número pessoal, comandos rápidos, grupos técnicos e aprovações com botão. Enquanto o WhatsApp costuma ser o canal mais natural para clientes e conversas pessoais, o Telegram funciona muito bem como painel operacional: você cria um bot no BotFather, conecta ao OpenClaw e passa a receber resumos, alertas, briefings e pedidos de confirmação sem misturar tudo na sua conta principal.

O ponto forte do Telegram com IA não é apenas conversar com um chatbot. O melhor uso é criar uma superfície de controle para rotinas que rodam enquanto você dorme: briefing matinal, resumo de mensagens, alerta de erro, aprovação de envio, lembrete de follow-up, triagem de leads e comandos curtos como /status, /agenda ou /resumo. O OpenClaw fica como operador local-first; o Telegram vira o lugar onde você revisa e decide.

Este guia, atualizado em julho de 2026, mostra como configurar o canal, quando usar conversa direta ou grupo, quais permissões revisar, como evitar excesso de mensagens e como diagnosticar quando o bot Telegram não responde. Se você ainda não instalou a base, comece pelo guia de instalação do OpenClaw e depois volte para conectar o canal.

Quando Telegram com IA faz sentido

Telegram faz sentido quando você precisa de um bot próprio, não de uma automação escondida dentro de outro aplicativo. Ele é especialmente útil para:

1. receber aprovações antes de o OpenClaw publicar, enviar email ou alterar arquivo;
2. rodar comandos pessoais rápidos pelo celular;
3. organizar grupos técnicos com menções explícitas ao bot;
4. receber alertas de automações, deploys, backups e rotinas de madrugada;
5. separar operação pessoal do número de WhatsApp;
6. testar fluxos de agente antes de levar para canais mais sensíveis.

Um exemplo simples de uso seguro:

/resumo hoje

O OpenClaw pode responder com mensagens importantes, reuniões do dia, bloqueios e ações pendentes. Depois, uma ação com impacto externo deve pedir confirmação:

Rascunhei a resposta para o cliente Alfa. Responda APROVAR para enviar ou AJUSTAR para revisar.

Esse padrão é melhor do que deixar o agente postar automaticamente em qualquer canal. O Telegram vira uma mesa de revisão: leitura e resumo podem ser automáticos; escrita externa, alteração de dados e decisões reputacionais precisam de aprovação humana. Para transformar isso em política operacional, use o guia de human-in-the-loop em IA no OpenClaw.

Configuração rápida com BotFather

O Telegram usa bots oficiais criados pelo BotFather. Você não precisa compartilhar seu número pessoal com o OpenClaw.

1. Abra o Telegram e fale com @BotFather.
2. Envie /newbot.
3. Escolha um nome visível, como Meu Assistente IA.
4. Escolha um username terminado em _bot, como meuassistente_openclaw_bot.
5. Copie o token gerado.
6. Guarde o token como segredo local. Não cole em grupo, print, issue ou prompt público.

Depois configure o canal:

openclaw channel add telegram --token YOUR_BOT_TOKEN

Em seguida, abra conversa direta com o bot e envie /start. Se o gateway do OpenClaw estiver rodando, você já pode testar:

/status

Se sua instalação usa arquivo de configuração, mantenha o token em variável de ambiente ou gerenciador de segredos. Um exemplo seguro de estrutura é:

channels:
  telegram:
    enabled: true
    token_env: "OPENCLAW_TELEGRAM_TOKEN"
    mode: "direct"

Conversa direta, grupo ou canal?

A escolha muda o risco operacional.

Conversa direta é o modo mais seguro para comandos pessoais, aprovações e alertas privados. Use para briefing matinal, resumo de email, confirmação de envio, status de automações e rotinas com dados sensíveis.

Grupo privado funciona bem para equipe pequena, suporte interno ou projeto técnico. Nesse caso, prefira modo por menção: o bot só responde quando alguém chama @NomeDoBot ou usa comando explícito. Isso evita que o agente interprete toda conversa como tarefa.

Canal de broadcast serve para relatórios e avisos, não para conversa. Use quando o OpenClaw deve publicar um resumo diário ou alerta de status para várias pessoas, mas mantenha escrita limitada e revisável.

Configuração recomendada para grupos:

channels:
  telegram:
    groups:
      mode: "mentions"
      allowed_chats:
        - "-1001234567890"

Evite mode: "always" em grupos grandes. O custo pode subir, a conversa pode ficar barulhenta e o agente pode responder fora de contexto. Se você precisa de leitura contínua, comece com um grupo pequeno de teste e registre claramente quais mensagens podem ser processadas.

Comandos úteis para começar

Você pode definir comandos no BotFather com /setcommands. Um conjunto inicial enxuto:

status - Ver status do OpenClaw
agenda - Resumir agenda de hoje
resumo - Listar decisões e pendências recentes
aprovar - Aprovar última ação pendente
cancelar - Cancelar última ação pendente
ajuda - Ver exemplos de uso

Depois conecte esses comandos às rotinas que você realmente usa. Para um operador pessoal, /agenda pode ler calendário e mensagens importantes. Para uma equipe, /resumo pode organizar decisões do grupo. Para um deploy, /status pode devolver último build, erros e links relevantes.

Um bom comando inclui fonte, período e limite:

/resumo últimas 24h: decisões, pendências, riscos e perguntas abertas. Não envie mensagem para fora deste chat.

Um comando ruim depende de adivinhação:

vê aí o que aconteceu

Essa diferença também aparece no guia OpenClaw não responde: quando o pedido é vago, o problema pode parecer técnico, mas na verdade falta contexto executável.

Voice notes e mensagens longas

Telegram é ótimo para áudio. Você pode mandar uma voice note como:

Resume minhas pendências de hoje e separa o que posso resolver em 15 minutos.

O OpenClaw pode transcrever, interpretar e responder em formato curto. Para uso recorrente, defina limites:

1. transcrever áudio apenas em conversa direta ou grupos permitidos;
2. não executar ação externa a partir de áudio sem confirmação por texto;
3. resumir antes de agir quando o áudio tiver vários pedidos;
4. apagar ou reter transcrições conforme sua política local.

Esse cuidado evita que um comando falado no trânsito vire uma ação irreversível. O agente pode preparar; você confirma.

Aprovações com botões

Inline keyboards são um diferencial do Telegram. O OpenClaw pode enviar uma proposta com botões:

Enviar resposta para Cliente Alfa?

Resumo:
- confirma recebimento do pedido
- promete retorno até 16h
- não altera preço

[Aprovar] [Ajustar] [Cancelar]

Use botões para ações de baixo e médio risco, como enviar resumo interno, marcar lembrete, confirmar rotina, arquivar alerta ou gerar relatório. Para ações sensíveis, como enviar proposta comercial, publicar conteúdo público, alterar produção ou responder em nome de alguém, mantenha revisão humana explícita.

Esse mesmo princípio aparece nos guias de Slack com IA e Microsoft Teams com IA: o canal pode ser a superfície de aprovação, mas a autoridade continua com a pessoa responsável.

Rotinas boas para Telegram

Comece com rotinas pequenas e observáveis:

1. Briefing matinal: agenda, emails importantes, mensagens pendentes e primeiro próximo passo.
2. Resumo de grupo: decisões, dúvidas sem resposta e responsáveis mencionados.
3. Alerta de erro: serviço afetado, horário, evidência e próxima ação segura.
4. Follow-up comercial: rascunho de resposta para aprovar antes de enviar.
5. Diário Noturno: o que rodou de madrugada, custo estimado, falhas e aprovações aguardando.

Para automações de rotina, conecte com receitas como briefing matinal, resumo semanal e backup automático. Para fluxos de reunião, use também meeting prep e resumo de reunião.

Segurança e privacidade

O token do bot controla seu canal. Trate como senha. Se ele vazou, revogue no BotFather e gere outro. Não mande o token para o próprio bot perguntando se está certo.

Revise também:

1. quais chats são permitidos;
2. se grupos exigem menção;
3. quem pode aprovar ações;
4. quais comandos podem executar escrita externa;
5. quanto contexto o agente pode ler;
6. por quanto tempo logs e transcrições ficam guardados.

Em grupos, explique que o bot existe e quando ele lê mensagens. Para empresa ou comunidade, não use o Telegram como atalho para coletar dados pessoais sem aviso. O melhor padrão é mínimo acesso, comandos explícitos e recibo claro do que foi feito.

Troubleshooting: bot Telegram não responde

Se o bot aparece no Telegram, mas não responde, siga a ordem mais barata:

openclaw status
openclaw telegram status
openclaw logs

Depois confirme:

1. você enviou /start na conversa direta;
2. o token ainda é o token atual no BotFather;
3. o gateway do OpenClaw está rodando;
4. o chat ou grupo está na allowlist;
5. o grupo permite que o bot leia mensagens;
6. você mencionou o bot se o modo for mentions;
7. não existe outra instância consumindo polling do mesmo bot;
8. modelo local ou API está disponível para gerar resposta.

O erro Forbidden: bot was blocked indica que o usuário bloqueou o bot. O erro de conflito de polling indica que mais de um processo está tentando receber updates do mesmo token. Erros de modelo, quota ou timeout não são problema do Telegram; nesse caso, o canal recebeu a mensagem, mas a camada de resposta falhou.

Se apenas Telegram falha e WhatsApp, Slack ou terminal respondem, foque em token, chat, permissões e polling. Se nenhum canal responde, volte para o diagnóstico geral em OpenClaw não responde.

Casos de uso reais no Telegram

O Telegram brilha como painel de controle. Quatro fluxos reais cobrem a maior parte do uso seguro:

1. Operador pessoal de um solo founder. Toda manhã, às 7h, o OpenClaw posta na conversa direta o briefing matinal: agenda do dia, emails que exigem resposta, mensagens pendentes e o primeiro próximo passo. Antes de enviar qualquer resposta externa, o agente mostra o rascunho com botões [Aprovar] e [Ajustar]. Você decide com o café na mão, sem abrir seis abas. Comece pela receita de briefing matinal e ajuste as fontes para o seu calendário e caixa de entrada.

2. Alerta de erro para um time de engenharia. Em um grupo privado com modo mentions, o OpenClaw envia um resumo sempre que um deploy falha ou um serviço cai: serviço afetado, horário, últimas linhas de log e um link para o runbook. O time discute no mesmo grupo; o bot só fala quando é chamado. Isso separa o sinal (alerta curto e acionável) do ruído (conversa humana).

3. Triagem de pedidos em um pequeno e-commerce. O agente lê novos pedidos, classifica por valor e risco (pagamento suspeito, endereço fora do padrão, produto sem estoque) e manda um resumo com os que precisam de atenção humana. Ações de baixo risco — confirmar recebimento, mandar código de rastreio — saem como rascunho para você aprovar com um toque. Para o fluxo completo por área, veja os casos de uso por profissão.

4. Fila de ideias para criador de conteúdo. Mande voice notes durante o dia com ideias soltas; o OpenClaw transcreve, agrupa por tema e devolve, no fim da semana, uma pauta organizada com os melhores ângulos. O Telegram vira o rascunho; a edição final fica em outro lugar. Para conectar isso a um pipeline de conteúdo, veja resumo de reunião e calendário de conteúdo.

Em todos os casos, o princípio é o mesmo: o agente prepara, resume e propõe; a pessoa revisa e decide o que sai para fora.

Quanto custa rodar um bot de Telegram com IA?

A boa notícia: a Bot API do Telegram é gratuita, sem mensalidade e sem cobrança por mensagem (ao contrário da WhatsApp Business API, que cobra por conversa iniciada). O OpenClaw também é 100% gratuito e open source. O custo real, portanto, vem só dos tokens do modelo de IA que você conecta ao bot.

Para reduzir a conta sem perder qualidade, combine modelos: mande as mensagens simples para um modelo barato (ou para o Ollama local) e suba só as perguntas difíceis para o Claude. Veja o lado a lado de preços no comparativo de modelos. Os valores mudam com o tempo — confira sempre os preços atuais no console do provedor antes de planejar o orçamento.

Telegram vs WhatsApp: qual canal de IA escolher?

Os dois funcionam com o OpenClaw, mas servem para coisas diferentes. A tabela resume a diferença prática:

A regra prática: use WhatsApp para conversas onde seus clientes e contatos já estão (atendimento, vendas, suporte); use Telegram para comando, aprovação e operação — o painel onde você revisa o que o agente fez de madrugada. Muita gente usa os dois juntos: o agente trabalha no Telegram e responde ao cliente no WhatsApp. Para configurar o lado WhatsApp, veja o guia de WhatsApp com IA e o tutorial de Claude no WhatsApp.

FAQ

O bot de Telegram no OpenClaw é grátis?

Sim. A Bot API do Telegram é gratuita e o OpenClaw é open source. O único custo é o do modelo de IA (Claude, GPT ou Gemini) que você conecta ao bot — e você pode zerar isso rodando um modelo local com Ollama.

Preciso de um número de telefone separado para o Telegram?

Não. O Telegram usa bots oficiais criados no BotFather, com token, sem expor seu número pessoal. Você só precisa de uma conta no Telegram para criar e falar com o bot. Isso é uma vantagem sobre o WhatsApp, que exige um número dedicado.

Qual a diferença entre Telegram e WhatsApp para IA?

O Telegram é melhor para operação: botões de aprovação nativos, grupos com modo por menção, canal grátis e separação do número pessoal. O WhatsApp é melhor para chegar onde seus clientes já estão. Para detalhes, veja a seção Telegram vs WhatsApp acima.

O bot consegue ler todas as mensagens do meu grupo?

Depende da configuração. Em modo mentions, o bot só responde quando é chamado explicitamente. Em modo always, ele lê toda a conversa — por isso recomendamos mentions em grupos e always só em conversa direta. Sempre avise o grupo de que o bot existe e quando ele lê mensagens.

Como faço aprovação com botões no Telegram?

O OpenClaw pode enviar uma proposta com inline keyboard ([Aprovar] [Ajustar] [Cancelar]). Use para ações de baixo e médio risco, como enviar resumo interno, criar lembrete ou arquivar alerta. Para ações sensíveis (enviar proposta comercial, publicar em público, alterar produção), mantenha revisão humana explícita. O guia de human-in-the-loop em IA detalha a política completa.

Posso usar o mesmo bot em vários grupos?

Sim, desde que cada chat esteja na allowlist. Em grupos, prefira modo mentions para evitar respostas fora de contexto e controlar custo. Registre claramente quais grupos o bot pode processar.

O token do BotFather expira?

O token não expira sozinho, mas pode ser revogado no BotFather a qualquer momento. Se ele vazou (em print, issue ou prompt público), revogue e gere outro imediatamente, depois atualize a variável de ambiente no OpenClaw. Nunca cole o token em grupo ou chat.

Qual modelo de IA funciona melhor no Telegram?

Depende da tarefa. Para aprovações e resumos curtos, um modelo rápido e barato basta. Para análise de contrato, escrita longa ou raciocínio cuidadoso, o Claude costuma ser a melhor escolha — e como o OpenClaw deixa trocar de modelo sem refazer o canal, você pode testar todos no mesmo bot. Veja o comparativo de modelos lado a lado.

Próximos passos

Depois que o Telegram estiver funcionando, conecte uma rotina real em vez de deixar o bot sem função:

1. configure /status para verificar saúde do OpenClaw;
2. crie um briefing matinal em conversa direta;
3. use inline keyboard para aprovar uma ação simples;
4. teste um grupo privado com modo mentions;
5. documente quais ações o bot nunca deve executar sem aprovação.

Se você quer comparar canais, veja WhatsApp, Slack, Microsoft Teams e Discord. A escolha prática é simples: WhatsApp para conversas onde seus clientes já estão, Telegram para comando e aprovação rápida, Slack ou Teams para equipe, Discord para comunidade.

Telegram com IA fica poderoso quando vira controle operacional, não brinquedo de chat. Configure pouco, teste em conversa direta, force aprovações para ações sensíveis e deixe o OpenClaw trabalhar de madrugada com um recibo claro para você revisar de manhã.