---
title: "Conectar Anthropic (Claude) ao Telegram com OpenClaw"
url: "https://openclaw.ia.br/conectar/anthropic-telegram/"
markdown_url: "https://openclaw.ia.br/conectar/anthropic-telegram.MD"
description: "Guia passo a passo para conectar Anthropic (Claude) ao Telegram via OpenClaw. Use Claude como modelo de linguagem no OpenClaw direto do Telegram."
date: "2026-02-18"
author: ""
---

# Conectar Anthropic (Claude) ao Telegram com OpenClaw

Guia passo a passo para conectar Anthropic (Claude) ao Telegram via OpenClaw. Use Claude como modelo de linguagem no OpenClaw direto do Telegram.


## 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](/glossario/) para entender termos como context window, tokens e system prompt antes de começar.

## Pré-requisitos

Antes de começar, você precisa:

1. ✅ **[OpenClaw instalado](/instalacao/)** — leva 5 minutos
2. ✅ **Telegram conectado** — Crie um bot no Telegram via @BotFather e configure o token no OpenClaw. Veja o [guia de conexão Telegram](/canais/telegram/).
3. ✅ **Conta na Anthropic com API key** — Crie em [console.anthropic.com](https://console.anthropic.com) e gere uma chave com créditos disponíveis
4. ✅ **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](https://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:

```yaml
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:

```yaml
# 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](/guias/) 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`, `/analisar` que 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](/integracoes/), resumir e-mails do [Gmail](/integracoes/) ou comentar PRs do [GitHub](/integracoes/).

## 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](/troubleshooting/) ou os [artigos do blog](/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](/guias/).

**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](https://www.anthropic.com/privacy) 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](/seguranca/) para configurações de acesso.

## Próximos Passos

- [Receitas prontas com IA](/receitas/) — automatizações que funcionam desde o primeiro dia
- [Skills personalizados](/skills/) — crie funções avançadas para seu caso de uso
- [Integrações disponíveis](/integracoes/) — conecte Gmail, GitHub, Notion e mais ao Claude
- [Outros canais disponíveis](/canais/) — use o mesmo assistente no WhatsApp, Slack ou Discord
- [Guia de segurança](/seguranca/) — proteja suas credenciais e configure permissões
- [FAQ geral](/faq/) — perguntas frequentes sobre o OpenClaw