OpenClaw no Telegram: seu assistente de IA auto-hospedado em um chat

O Telegram é a forma mais rápida de colocar o OpenClaw no bolso. Um token de bot leva cerca de um minuto para ser criado, não há processo de aprovação e nenhum número de telefone dedicado está envolvido. Depois de conectado, você conversa com seu próprio assistente auto-hospedado do mesmo jeito que conversa com qualquer outro contato.

Por que o Telegram é a integração mais fácil

Toda plataforma de mensagens exige algo de você antes de deixar um programa falar em seu nome. O WhatsApp quer um número de telefone e, para qualquer uso além do pessoal, uma conta comercial na Meta. O Discord quer um aplicativo, uma URL de convite e uma decisão sobre intents privilegiados. O Telegram quer uma conversa com um bot chamado BotFather, e depois entrega um token.

• Sempre no bolso. Envie mensagens ao seu assistente como a qualquer outro contato do Telegram, pelo celular, pelo computador ou pelo cliente web, com a conversa sincronizada em todos eles.
• Sem número, sem aprovação. Um bot não está ligado a um número de telefone, então não custa nada criar e nada abandonar se você mudar de ideia.
• Agnóstico de modelo. O bot é apenas a superfície. Por trás dele, o OpenClaw pode apontar para OpenAI, Anthropic, Google ou um modelo local, e você pode mudar isso sem tocar no Telegram.
• Mais do que texto. Mensagens de voz, imagens e documentos chegam como mensagens nas quais seu assistente pode agir, o que torna uma janela de chat uma interface surpreendentemente capaz.

Como conectar o OpenClaw ao Telegram

1. Crie um bot. No Telegram, envie mensagem para @BotFather, execute /newbot e escolha um nome de exibição e um nome de usuário terminando em bot. O BotFather responde com um token que parece uma longa sequência de dígitos e letras.
2. Trate o token como uma senha. Quem o tiver pode agir como seu bot. Se ele vazar, /revoke no BotFather o invalida imediatamente e emite um novo.
3. Implante o OpenClaw. Se ainda não fez, implante sua instância na Flux em cerca de 30 segundos.
4. Cole o token. No seu painel do OpenClaw, adicione a integração do Telegram e cole o token.
5. Comece a conversar. Abra o chat com seu bot e envie uma mensagem. A resposta vem da sua própria instância.

Enquanto ainda estiver no BotFather, duas configurações opcionais valem a pena agora, e não depois. /setdescription e /setabouttext controlam o que as pessoas veem antes de iniciar uma conversa, e /setcommands dá ao seu bot um menu de comandos, que é a diferença entre um assistente que parece pronto e um que parece um protótipo.

Usando em um grupo

Um bot do Telegram se comporta de forma diferente em um grupo do que em uma mensagem direta, e a diferença pega quase todo mundo uma vez. Os bots são criados com o Privacy Mode ativado, o que significa que, em um grupo, eles só recebem mensagens que começam com um comando de barra, ou que respondem ou mencionam o bot diretamente. Todas as outras mensagens daquele grupo nunca chegam ao seu servidor.

É por isso que o mesmo bot pode responder perfeitamente às suas mensagens diretas e parecer completamente morto em um grupo. Ele não está ignorando ninguém; ele realmente nunca ouviu. Desative o Group Privacy no BotFather, em Bot Settings, depois remova o bot do grupo e adicione-o de novo, porque a configuração entra em vigor quando o bot entra. Nosso guia sobre um assistente que para de responder cobre isso e a armadilha equivalente no Discord com mais detalhes.

Vale uma pausa antes de clicar adiante, porém. Com o Privacy Mode desativado, o assistente recebe tudo o que é dito naquele grupo. Isso é exatamente o que você quer para um chat pequeno de família ou de equipe, e exatamente o que você não quer em um grande.

O que o Telegram vê e o que não vê

A auto-hospedagem muda muito em termos de privacidade, e vale ser preciso sobre o que ela muda em vez de vendê-la demais.

O que ela muda: suas mensagens são processadas por uma instância que você controla. Não há um fornecedor terceirizado de bot entre você e seu assistente, nenhum serviço compartilhado acumulando seu histórico de conversas e nenhum produto cujos termos possam mudar por baixo de você. Se você apontar o OpenClaw para um modelo local, o conteúdo das suas conversas nunca sai do seu próprio servidor.

O que ela não muda: mensagens de bots do Telegram passam pelo Telegram. A Bot API não é criptografada de ponta a ponta, e as mensagens para um bot não ficam em um Chat Secreto, então o próprio Telegram processa o conteúdo em trânsito, independentemente de quem roda o bot. A auto-hospedagem remove o intermediário extra; não remove a plataforma. Para a maioria das pessoas, é uma boa troca e vale ser feita conscientemente. Se ela não for aceitável para uma conversa específica, essa conversa pertence à interface web do OpenClaw e não a nenhuma plataforma de chat.

Limites que vale conhecer antes de depender dele

A Bot API do Telegram tem alguns limites que só ficam visíveis quando você os atinge:

• Tamanho de arquivo. Bots podem baixar arquivos de até 20 MB pela Bot API e enviar arquivos de até 50 MB. Um vídeo grande ou uma gravação longa simplesmente não chegará ao seu assistente, e a falha é silenciosa, não barulhenta.
• Limites de taxa. O Telegram limita a velocidade com que um bot pode enviar mensagens, o que importa se seu assistente produz longos fluxos de saída em vez de respostas únicas.
• Tamanho da mensagem. Uma única mensagem do Telegram tem limite de 4,096 caracteres, então respostas longas chegam divididas em várias mensagens.

Nenhum deles é um problema para o uso do dia a dia. São o tipo de coisa que vale saber de antemão, para que uma falha silenciosa seja lida como um limite documentado e não como uma integração quebrada.

Para que as pessoas realmente usam

O padrão que torna um assistente de chat valioso não é fazer perguntas a ele, o que uma aba do navegador já faz bem. São as coisas que se beneficiam de estar a uma mensagem de distância: encaminhar um artigo e pedir o argumento em três linhas, enviar a foto de um documento e perguntar o que ele diz, ditar uma nota de voz enquanto caminha e receber um resumo escrito de volta, ou acionar algo na sua própria rede sem abrir um notebook. Uma janela de chat é uma interface de baixo atrito, e baixo atrito é o que transforma uma ferramenta em hábito.

Comece

O Telegram é uma das mais de 20 integrações. Explore o WhatsApp e o Discord também, dimensione sua instância com os requisitos de servidor ou leia o guia completo para auto-hospedar o OpenClaw. Pronto para começar? Implante a partir da página inicial.