Como Conectar o OpenClaw ao Telegram — Guia Passo a Passo

Introdução

O Telegram é ideal para interação de IA mobile-first. Com mais de 800 milhões de usuários ativos, é uma das plataformas de mensagens mais populares em todo o mundo. Conectar seu agente OpenClaw ao Telegram oferece um assistente de IA com o qual você pode conversar do seu telefone, tablet ou desktop - em qualquer lugar com uma conexão à internet.

Pré-requisitos

Uma conta KiwiClaw com um agente ativo (guia de configuração)
Uma conta do Telegram
Acesso a @BotFather no Telegram

Instruções Passo a Passo

Passo 1: Abra o BotFather no Telegram

Procure por @BotFather no Telegram ou abra t.me/BotFather. O BotFather é a ferramenta oficial do Telegram para criar e gerenciar bots.

Passo 2: Crie um Novo Bot

Envie /newbot para o BotFather. Ele pedirá um nome de exibição (por exemplo, "Meu Agente de IA") e um nome de usuário (por exemplo, "meuagenteia_bot"). O nome de usuário deve terminar com "bot".

Passo 3: Copie o Token do Bot

O BotFather responde com um token de API -- uma longa sequência de números e letras. Copie este token. Você o colará no KiwiClaw em seguida.

Passo 4: Abra o Painel do Seu KiwiClaw

Faça login em app.kiwiclaw.app, selecione seu agente e clique na aba Canais. Encontre o cartão do Telegram.

Passo 5: Cole o Token do Bot

Clique em Conectar ao Telegram e cole o token do bot do BotFather. O KiwiClaw valida o token e estabelece a conexão.

Passo 6: Comece a Conversar

Abra seu novo bot no Telegram (procure pelo nome de usuário) e envie uma mensagem. O agente responde pelo Telegram da mesma forma que faria pelo chat do painel.

Dicas Profissionais

Adicionar a grupos -- Você pode adicionar o bot a grupos do Telegram para perguntas e respostas da equipe. Configure se ele responde a todas as mensagens ou apenas quando @mencionado.
Usar no celular -- O aplicativo móvel do Telegram oferece assistência de IA em movimento, perfeito para pesquisa rápida ou delegação de tarefas.
Definir uma descrição do bot -- Envie /setdescription para o BotFather para adicionar uma descrição que aparece quando os usuários abrem seu bot pela primeira vez.
Combine com tarefas agendadas para receber briefings, lembretes ou relatórios diários diretamente no Telegram.

Perguntas Frequentes

Can I use my OpenClaw agent in Telegram group chats?

Yes. Add the bot to any Telegram group and configure it to respond to @mentions or all messages. Group mode works well for team Q&A and community management.

Is the Telegram connection secure?

Yes. Telegram uses end-to-end encryption for secret chats and TLS for all API communication. Your bot token is stored encrypted in KiwiClaw and never exposed to other tenants.

Can the Telegram bot send images and files?

Yes. Your agent can send images, documents, and other files through Telegram. If you install image generation skills like OpenAI Image Gen, the agent can create and send images directly in the chat.