Conectar Anthropic (Claude) ao Telegram com OpenClaw
Anthropic (Claude) + Telegram: Automatize IA pelo Chat
O Claude, modelo de linguagem da Anthropic, é reconhecido pela sua capacidade de raciocínio longo, análise cuidadosa e geração de textos com tom natural. Ao conectá-lo ao Telegram via OpenClaw, você transforma o app de mensagens — com seus bots nativos, grupos de até 200 mil membros e suporte a arquivos — em uma interface poderosa de IA.
A vantagem de usar Claude no Telegram está na combinação: o Telegram tem suporte nativo a bots com menus interativos e comandos /slash, enquanto Claude brilha em tarefas que exigem raciocínio mais profundo, como análise de documentos extensos, redação técnica e geração de código com explicações detalhadas. Juntos, permitem criar workflows de IA que substituem horas de trabalho manual.
Essa integração é ideal para desenvolvedores, pesquisadores, criadores de conteúdo e qualquer profissional que use o Telegram como hub de comunicação e queira IA disponível sem sair do app.
O que você consegue fazer:
- Conversar — sessões de chat com contexto persistente dentro do Telegram
- Raciocinar — análises passo a passo de problemas complexos
- Analisar documentos — envie PDFs, textos e planilhas para o bot processar
- Gerar código — Python, JavaScript, SQL e outros com explicações
- Resumir — documentos longos transformados em pontos essenciais
Veja o glossário para entender termos como context window, tokens e system prompt antes de começar.
Pré-requisitos
Antes de começar, você precisa:
- ✅ OpenClaw instalado — leva 5 minutos
- ✅ Telegram conectado — Crie um bot no Telegram via @BotFather e configure o token no OpenClaw. Veja o guia de conexão Telegram.
- ✅ Conta na Anthropic com API key — Crie em console.anthropic.com e gere uma chave com créditos disponíveis
- ✅ Modelo Claude habilitado — Claude 3.5 Sonnet é o modelo recomendado para uso geral
Configuração Passo a Passo
Passo 1: Criar seu Bot no Telegram
Abra o Telegram e inicie uma conversa com @BotFather. Digite /newbot e siga as instruções: defina um nome e um username para o bot (deve terminar em bot). O BotFather entregará um token no formato 123456789:ABCdef... — copie-o.
Para habilitar recebimento de mensagens em grupos, envie ao BotFather: /setprivacy → selecione seu bot → Disable.
Passo 2: Obter sua API Key da Anthropic
Acesse console.anthropic.com/settings/keys, clique em Create Key e copie a chave gerada. Configure também um limite de gastos mensal em Billing > Usage Limits como precaução.
Passo 3: Configurar no OpenClaw
No arquivo config.yaml, adicione:
llm:
provider: anthropic
model: claude-3-5-sonnet-20241022
api_key: sk-ant-sua-chave-aqui
max_tokens: 4096
channels:
telegram:
token: "123456789:ABCdef-seu-token-aqui"
allowed_users: [] # deixe vazio para permitir todos
Salve e reinicie: openclaw gateway restart
Passo 4: Testar a Conexão
Abra o Telegram e inicie o bot com /start. Em seguida, envie:
“Teste a conexão com Anthropic Claude”
Se tudo estiver correto, o OpenClaw responde confirmando que a integração está ativa e exibe a versão do Claude em uso.
Passo 5: Personalizar o Comportamento
No arquivo soul.md do seu workspace, configure como Claude deve agir:
# Exemplo no soul.md
Você é um assistente especializado em [sua área].
Modelo: Claude 3.5 Sonnet
Canal principal: Telegram
Comportamento:
- Use formatação Markdown (suportado pelo Telegram)
- Respostas em português brasileiro
- Seja direto nas respostas curtas, detalhado quando pedido
- Sempre pergunte se ficou dúvida ao final de explicações técnicas
Veja o guia completo de personalização para opções avançadas.
Exemplos de Uso
Exemplo 1: Análise de Documento Longo
Envie um PDF ou texto para o bot no Telegram com o comando:
“Analise este documento e me diga: 1) Os 5 pontos principais, 2) Possíveis riscos, 3) O que precisa de atenção imediata”
O Claude processa o conteúdo completo e responde com análise estruturada. Sua context window de 200K tokens permite analisar documentos muito extensos sem perder conteúdo.
Exemplo 2: Raciocínio Passo a Passo
Envie no Telegram:
“Minha empresa tem 50 funcionários e quero implementar IA nos processos internos com orçamento de R$ 5.000/mês. Quais seriam as melhores aplicações e por onde começar?”
O Claude raciocina sobre o problema, considera trade-offs e entrega um plano detalhado e priorizado.
Exemplo 3: Geração e Revisão de Código
Envie no Telegram:
“Escreva uma função Python que lê um CSV, remove duplicatas por e-mail, e exporta para um novo arquivo com a contagem de duplicatas removidas”
O Claude gera o código com comentários, tratamento de erros e sugestão de testes.
Exemplo 4: Criação de Conteúdo com Instruções Específicas
Envie no Telegram:
“Escreva 5 posts para LinkedIn sobre automação com IA. Tom: profissional mas acessível. Inclua uma pergunta para engajamento em cada post. Máximo 150 palavras por post.”
Dicas e Boas Práticas
- Aproveite a context window grande: Claude suporta até 200K tokens de contexto. Para análises de documentos longos, cole o conteúdo diretamente — não precisa de resumo prévio.
- Use comandos slash no Telegram: Configure atalhos como
/resumir,/traduzir,/analisarque chamam prompts pré-configurados. Isso agiliza tarefas repetitivas. - Configure grupos privados: Crie um grupo no Telegram só com você e o bot para ter um espaço de trabalho limpo e organizado.
- Itere as respostas: O Claude responde bem a refinamentos. Se a primeira resposta não foi ideal, diga “torne mais formal” ou “reduza para 3 parágrafos” sem precisar repetir o prompt.
- Combine com integrações: Use Claude para analisar dados do Google Sheets, resumir e-mails do Gmail ou comentar PRs do GitHub.
Solução de Problemas Comuns
| Problema | Solução |
|---|---|
| “Integração não responde” | Verifique a API key da Anthropic em config.yaml e confira créditos na conta |
| “Erro de autenticação” | Gere nova API key no console da Anthropic e atualize o config.yaml |
| “Mensagens não chegam” | Confirme que o bot do Telegram está ativo com /status |
| “Respostas lentas” | Claude Sonnet pode demorar para respostas longas; use claude-3-haiku para respostas rápidas |
| “Bot não responde em grupos” | Configure privacy mode desabilitado via BotFather |
| “Erro overload_error” | A API da Anthropic está sobrecarregada; aguarde alguns segundos e tente novamente |
Para problemas não listados, consulte o guia de troubleshooting ou os artigos do blog com soluções detalhadas.
FAQ
Qual modelo Claude devo usar?
Para uso geral no Telegram, claude-3-5-sonnet-20241022 é o melhor equilíbrio entre qualidade e velocidade. Para respostas rápidas e simples, use claude-3-haiku. Para análises muito complexas, considere claude-3-opus.
Claude pode analisar imagens enviadas no Telegram? Sim, Claude 3 é multimodal. Configure o OpenClaw para encaminhar imagens do Telegram para a API da Anthropic. Veja o guia de configuração multimodal.
Posso ter múltiplos bots Telegram com modelos diferentes?
Sim. Crie bots diferentes no BotFather e configure cada um com um config.yaml separado no OpenClaw. Útil para ter um bot “rápido” com Haiku e um “aprofundado” com Sonnet.
Os dados das conversas vão para os servidores da Anthropic? O conteúdo das mensagens é enviado para a API da Anthropic para processamento. A Anthropic não usa dados de API para treinar modelos por padrão. Veja a política de privacidade da Anthropic para detalhes completos.
Como limitar quem pode usar o bot?
No config.yaml, adicione os IDs do Telegram em allowed_users. Somente esses usuários receberão respostas do bot. Veja o guia de segurança para configurações de acesso.
Próximos Passos
- Receitas prontas com IA — automatizações que funcionam desde o primeiro dia
- Skills personalizados — crie funções avançadas para seu caso de uso
- Integrações disponíveis — conecte Gmail, GitHub, Notion e mais ao Claude
- Outros canais disponíveis — use o mesmo assistente no WhatsApp, Slack ou Discord
- Guia de segurança — proteja suas credenciais e configure permissões
- FAQ geral — perguntas frequentes sobre o OpenClaw