--- title: "Bot Telegram com IA — Guia OpenClaw" url: "https://openclaw.ia.br/canais/telegram/" markdown_url: "https://openclaw.ia.br/canais/telegram.MD" description: "Crie um bot Telegram com IA no OpenClaw para comandos pessoais, grupos, aprovações e rotinas de madrugada com segurança e controle humano." date: "2026-05-22" author: "" --- # Bot Telegram com IA — Guia OpenClaw Crie um bot Telegram com IA no OpenClaw para comandos pessoais, grupos, aprovações e rotinas de madrugada com segurança e controle humano. # 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 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](/instalacao/) 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: ```text /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: ```text 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](/blog/human-in-the-loop-ia-aprovacao-agentes-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](https://t.me/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: ```bash 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: ```text /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 é: ```yaml 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: ```yaml 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: ```text 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: ```text /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: ```text vê aí o que aconteceu ``` Essa diferença também aparece no guia [OpenClaw não responde](/blog/openclaw-nao-responde-guia-diagnostico/): 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: ```text 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: ```text 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](/blog/slack-com-ia-openclaw-aprovacoes-equipe/) e [Microsoft Teams com IA](/blog/microsoft-teams-com-ia-openclaw/): 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](/receitas/briefing-matinal/), [resumo semanal](/receitas/resumo-semanal/) e [backup automático](/receitas/backup-automatico/). Para fluxos de reunião, use também [meeting prep](/receitas/meeting-prep/) e [resumo de reunião](/receitas/resumo-reuniao/). ## 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: ```bash 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](/blog/openclaw-nao-responde-guia-diagnostico/). ## 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](/canais/whatsapp/), [Slack](/canais/slack/), [Microsoft Teams](/canais/teams/) e [Discord](/canais/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ã.