Guia do OpenClaw Telegram: configuração e configuração completa do bot

Introdução

O Telegram é uma das melhores plataformas para bots de IA, graças à sua robusta API de bot e recursos como comandos embutidos, teclados e suporte para chat em grupo. A integração do OpenClaw com Telegram aproveita esses recursos para fornecer uma experiência de assistente de IA poderosa e interativa.

Este guia cobre tudo que você precisa para configurar o OpenClaw como um bot do Telegram, desde a criação do bot até a configuração de recursos avançados.

Para outras integrações de aplicativos de bate-papo, consulte nossos guias:

• Configuração do WhatsApp
• Configuração do Discord
• Configuração do Slack
• Configuração do iMessage

Por que telegrama?

O Telegram oferece várias vantagens para bots de IA:

• API oficial do bot — API robusta e bem documentada
• Comandos Inline — Ações rápidas sem digitar
• Teclados personalizados — Botões interativos
• Suporte por chat em grupo — Funciona em grupos e canais
• Suporte a arquivos — Enviar/receber documentos, imagens, áudio
• Privacidade — Melhores controles de privacidade do que muitas plataformas

Pré-requisitos

Antes de configurar a integração do Telegram:

1. OpenClaw instalado — Consulte guia de instalação
2. OpenClaw configurado — Execute openclaw onboard para configurar seu modelo de IA
3. Conta do Telegram — Conta ativa do Telegram
4. Bot Token — Você o criará na próxima etapa

Etapa 1: Crie um bot de telegrama

Usando @BotFather

1. Abra o Telegram e procure por @BotFather
2. Inicie um bate-papo com @BotFather
3. Enviar comando /newbot
4. Escolha um nome para o seu bot (por exemplo, “Meu OpenClaw Assistant”)
5. Escolha um nome de usuário (deve terminar em bot, por exemplo, “myopenclaw_bot”)
6. Copie o token do bot — Você verá algo como:

   123456789:ABCdefGHIjklMNOpqrsTUVwxyz

Importante: Mantenha seu token de bot em segredo! Não compartilhe publicamente.

Configurações do bot (opcional)

Configure seu bot com @BotFather:

• /setdescription — Definir descrição do bot
• /setabouttext — Defina o texto
• /setuserpic — Definir foto de perfil do bot
• /setcommands — Definir lista de comandos (veja abaixo)

Configurando comandos de bot

Defina comandos que os usuários podem ver:

/start - Start chatting with OpenClaw
/help - Get help and commands
/email - Check your email
/calendar - View calendar
/tasks - List tasks
/weather - Get weather
/briefing - Daily briefing

Envie /setcommands para @BotFather e cole os comandos acima.

Etapa 2: configurar o OpenClaw

Executar configuração de integração

Inicie a integração do Telegram:

openclaw integrations telegram

Ou use o comando de integrações gerais:

openclaw integrations
# Select Telegram from the menu

Insira o token do bot

Quando solicitado, cole o token do bot:

Enter your Telegram bot token: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

O OpenClaw verificará o token e se conectará ao Telegram.

Verifique a conexão

Você deveria ver:

✓ Telegram bot connected successfully!
  Bot username: @myopenclaw_bot
  Start chatting: https://t.me/myopenclaw_bot

Etapa 3: comece a conversar

Iniciar uma conversa

1. Abra o Telegram e procure seu bot (por nome de usuário)
2. Toque em “Iniciar” ou envie /start
3. Envie uma mensagem como “Olá, você pode me ajudar?”

OpenClaw responderá através do seu bot!

Comandos de teste

Experimente estes comandos:

• /start — Iniciar conversa
• /help — Obtenha ajuda
• /email — Verifique e-mail (se configurado)
• /calendar — Ver calendário
• /tasks — Listar tarefas

Recursos avançados

Comandos embutidos

O Telegram oferece suporte a comandos embutidos que aparecem conforme você digita:

1. Digite @yourbotname em qualquer chat
2. Digite uma consulta como “previsão do tempo” ou “e-mail”
3. Selecione entre sugestões que aparecem

Configure comandos embutidos no OpenClaw:

openclaw config set telegram.inline true

Teclados personalizados

OpenClaw pode enviar teclados personalizados com botões:

openclaw config set telegram.keyboard true

Exemplo de layout de teclado:

[Email] [Calendar] [Tasks]
[Weather] [Briefing] [Help]

Os usuários podem tocar nos botões em vez de digitar comandos.

Suporte por bate-papo em grupo

OpenClaw funciona em chats em grupo:1. Adicione seu bot a um grupo 2. Conceda permissões (se necessário) 3. Mencione o bot ou use comandos:

• @myopenclaw_bot check email
• /email@myopenclaw_bot

Configure o comportamento do grupo:

openclaw config set telegram.groups.enabled true
openclaw config set telegram.groups.requireMention true

Manipulação de arquivos

OpenClaw pode lidar com arquivos enviados via Telegram:

• Imagens — Analisar e descrever
• Documentos — Leia PDFs, documentos do Word, etc.
• Áudio — Transcreve mensagens de voz
• Vídeo — Extraia informações

Envie um arquivo para o seu bot e peça ao OpenClaw para processá-lo.

Opções de configuração

Formatação de resposta

Configure como o OpenClaw formata as respostas:

openclaw config set telegram.format "markdown"

Opções:

• markdown — Formatação rica (negrito, itálico, links, código)
• html — formatação HTML
• plain — Texto simples

Limitação de taxa

Taxa de mensagens de controle:

openclaw config set telegram.rateLimit 30

Limita a 30 mensagens por minuto por usuário.

Configurações de privacidade

Configurar privacidade:

openclaw config set telegram.privacy.privateOnly true

Responda apenas a mensagens diretas, não a bate-papos em grupo.

Configurações de notificação

Notificações de controle:

openclaw config set telegram.notifications.enabled true
openclaw config set telegram.notifications.quietHours "22:00-08:00"

Dicas de uso

1. Atalhos de comando

Crie atalhos para tarefas comuns:

• /e → Verifique e-mail
• /c → Ver calendário
• /t → Listar tarefas
• /w → Clima

2. Mensagens agendadas

Configure briefings agendados:

openclaw config set telegram.schedules.dailyBriefing "08:00"

OpenClaw enviará um briefing diário às 8h.

3. Suporte multiusuário

OpenClaw oferece suporte a vários usuários:

• Cada usuário tem contexto separado
• A memória é específica do usuário
• As respostas são personalizadas

4. Integração de canais

Use OpenClaw em canais do Telegram:

1. Adicione bot como administrador ao canal
2. Conceda permissões de postagem
3. Configurar o comportamento do canal:

   openclaw config set telegram.channels.enabled true

5. Webhook vs pesquisa

OpenClaw usa polling por padrão (verifica mensagens periodicamente). Para melhor desempenho, configure webhooks:

openclaw config set telegram.webhook.enabled true
openclaw config set telegram.webhook.url "https://yourdomain.com/webhook"

Requer um servidor acessível publicamente.

Solução de problemas

Bot não responde

Se o seu bot não responder:

1. Verifique o status do bot:

   openclaw status

2. Verificar token:

   openclaw config get telegram.token

3. Verifique os registros:

   openclaw logs

4. Conexão de teste:

   openclaw test telegram

Token inválido

Se você vir erros de “token inválido”:

1. Verificar token — Verifique @BotFather para obter o token correto
2. Regenerar token — Use /revoke e depois /newbot em @BotFather
3. Token de atualização:

   openclaw integrations telegram

Mensagens não recebidas

Se as mensagens não estiverem sendo recebidas:

1. Verifique se o bot está em execução:

   openclaw status

2. Reinicie o OpenClaw:

   openclaw restart

3. Verifique a rede — Certifique-se de que o OpenClaw possa alcançar a API do Telegram

Problemas de bate-papo em grupo

Se o bot não funcionar em grupos:

1. Verifique as permissões — O bot precisa de permissões de mensagem

2. Ativar suporte de grupo:

   openclaw config set telegram.groups.enabled true

3. Requer menção:

   openclaw config set telegram.groups.requireMention true

Limitação de taxa

Se você atingir os limites de taxa:

1. Aumentar limite de taxa:

   openclaw config set telegram.rateLimit 60

2. Verifique os limites do Telegram — O Telegram tem limites de taxa de API

3. Use webhooks — Mais eficiente que pesquisas

Melhores práticas de segurança

Segurança de token de bot

• Mantenha o token em segredo — Nunca compartilhe publicamente

• Usar variáveis de ambiente:

  export TELEGRAM_BOT_TOKEN="your-token"

• Rodar token — Regenerar se comprometido:

  /revoke in @BotFather

Configurações de privacidade

• Modo privado — Responda apenas a mensagens diretas
• Lista de permissões de usuários — Restringir a usuários específicos:

  openclaw config set telegram.allowedUsers ["user1", "user2"]

Privacidade de dados

• Processamento local — Todas as mensagens processadas localmente
• Sem armazenamento em nuvem — A menos que seja explicitamente configurado
• Armazenamento seguro — Dados armazenados em ~/.openclaw## Casos de uso avançados

Colaboração em equipe

Use OpenClaw em grupos de equipe:

• Gerenciamento de tarefas — Atribua e rastreie tarefas
• Coordenação de calendário — Agendar reuniões
• Recuperação de informações — Respostas rápidas para a equipe

Produtividade Pessoal

Use como assistente pessoal:

• Gerenciamento de e-mail — Verifique e responda e-mails
• Calendário — Visualize e gerencie a programação
• Tarefas — Acompanhe todos e projetos

Criação de Conteúdo

Use para fluxos de trabalho de conteúdo:

• Geração de rascunhos — Crie rascunhos via Telegram
• Pesquisa — Colete informações
• Edição — Revise e edite o conteúdo

Comparação com outras plataformas

Telegram x WhatsApp

• Telegram — Conta de bot separada, mais recursos
• WhatsApp — Usa conta pessoal, configuração mais simples

Consulte nosso guia do WhatsApp para comparação.

Telegram vs Discord

• Telegrama — Melhor para uso pessoal, mais simples
• Discord — Melhor para servidores, mais recursos

Consulte nosso guia do Discord para obter detalhes.

Próximas etapas

Agora que o Telegram está conectado:

1. Explore outras integrações — WhatsApp, Discord, Slack
2. Configurar habilidades — Biblioteca de habilidades
3. Configurar e-mail — Integração com Gmail
4. Leia as perguntas frequentes — Perguntas comuns

Conclusão

A integração do Telegram oferece uma das melhores experiências para o OpenClaw, graças à robusta API de bot do Telegram e recursos como comandos embutidos e teclados personalizados. A configuração é simples: crie um bot com @BotFather, insira o token e comece a conversar.

Para obter mais ajuda, consulte nossa página de integrações ou FAQ. Feliz bate-papo com seu assistente de IA no Telegram!