Configuracao do Bot no Telegram

Guia passo a passo para conectar seu agente Claw Buff ao Telegram

Conecte seu agente de IA Claw Buff ao Telegram para que os usuarios possam conversar com ele via DM ou em chats de grupo. A configuracao leva cerca de 5 minutos.

Pre-requisitos

Uma conta no Telegram
Um agente Claw Buff implantado (Primeiros Passos)

Passo 1: Crie um Bot com o BotFather

Abra o BotFather

Abra o Telegram e procure por @BotFather (procure pela marca de verificacao azul). Este e o bot oficial do Telegram para criar e gerenciar bots.

Crie seu bot

Envie /newbot para o BotFather e siga as instrucoes:

Nome do bot — Um nome de exibicao para seu bot (ex.: "Meu Assistente IA")
Username do bot — Deve terminar em bot (ex.: meu_claw_bot)

Salve seu Token do Bot

O BotFather respondera com um Token do Bot parecido com:

123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

Copie este token — voce precisara dele no proximo passo.

Mantenha seu Token do Bot em segredo. Qualquer pessoa com o token pode controlar seu bot. Nunca o compartilhe em chats publicos ou faca commit dele no Git.

Passo 2: Conecte ao Claw Buff

Abra o Console do Claw Buff → pagina de Canais
Encontre o card do Telegram e clique em Connect
Cole seu Token do Bot do Passo 1
Clique em Save & Activate

Seu agente se conectara ao Telegram em segundos. Voce vera o status mudar para Connected.

Passo 3: Autorize o Acesso

Por padrao, seu bot usa o modo de pareamento — novos usuarios devem ser aprovados antes de poderem conversar. Quando alguem enviar uma mensagem ao seu bot pela primeira vez, vera:

OpenClaw: access not configured.
Your Telegram user id: 1234567890
Pairing code: ABCD1234
Ask the bot owner to approve with:
openclaw pairing approve telegram ABCD1234

Aprove via Solicitacoes Pendentes

Va para a pagina Console do Claw Buff → Canais. Quando alguem solicitar acesso, uma secao de Solicitacoes de Pareamento Pendentes aparecera automaticamente com o codigo pendente. Clique em Approve ao lado da solicitacao.

Os codigos de pareamento expiram apos 1 hora. Se expirar, o usuario so precisa enviar uma mensagem ao bot novamente para obter um novo codigo.

Gerencie Usuarios Autorizados

Voce tambem pode gerenciar o acesso diretamente. Clique em Manage no card do canal Telegram para:

Visualizar todos os usuarios autorizados atualmente
Adicionar um usuario inserindo seu ID de usuario do Telegram (autorizacao proativa)
Remover um usuario para revogar seu acesso

Passo 4: Comece a Conversar

Abra o Telegram, encontre seu bot pelo username e envie uma mensagem. Seu agente de IA respondera!

Configuracao de Chat em Grupo

Para usar seu bot em grupos do Telegram:

Adicione seu bot ao grupo
O bot respondera quando for @mencionado por padrao

Em grupos, o bot so responde quando mencionado (ex.: @meu_claw_bot qual e o clima?). Isso evita que o bot responda a todas as mensagens em grupos movimentados.

Recursos

Recurso	Suportado
Mensagens Diretas	Sim
Chats em Grupo	Sim (mencao necessaria)
Respostas em Streaming	Sim (digitacao em tempo real)
Formatacao Rica	Sim (HTML/Markdown)
Topicos de Forum	Sim
Anexos de Arquivos	Sim

Perguntas Frequentes

1. Bot nao responde?

Verifique o token — Certifique-se de que colou o token completo sem espacos extras
Verifique o Console — A pagina de Canais mostra o status da conexao e logs de erro
Problemas de rede — Seu agente precisa de acesso de saida para api.telegram.org na porta 443

2. Bot responde lentamente?

O streaming esta habilitado por padrao. O bot edita sua mensagem em tempo real conforme a IA gera a resposta. Se voce notar atrasos, verifique a configuracao do modelo em Console → Agent → Model.

3. "Forbidden: bot was blocked by the user"?

O usuario bloqueou seu bot no Telegram. Ele precisa desbloquea-lo e enviar /start novamente.