---
title: "Token Telegram Inválido — Solução"
url: "https://openclaw.ia.br/troubleshooting/token-telegram-invalido/"
markdown_url: "https://openclaw.ia.br/troubleshooting/token-telegram-invalido.MD"
description: "Como resolver erro de token inválido ou expirado do bot Telegram. Gerar novo token no BotFather."
date: ""
author: ""
---

# Token Telegram Inválido — Solução

Como resolver erro de token inválido ou expirado do bot Telegram. Gerar novo token no BotFather.


# Token Telegram Inválido

## Descrição do Problema

Erro ao conectar com o Telegram indicando token inválido:

```
Error: 401 Unauthorized
Invalid bot token
Bot token is invalid or expired
ETELEGRAM: Unauthorized
```

## Possíveis Causas

1. **Token digitado errado** - Erro de digitação ou espaços extras
2. **Token revogado** - Você gerou um novo token no BotFather
3. **Bot deletado** - O bot foi removido
4. **Formato incorreto** - Token incompleto ou malformado
5. **Variável de ambiente errada** - Token não está sendo lido

## Soluções

### 1. Verificar Token Atual

```bash
# Ver token configurado (parcial por segurança)
openclaw config show | grep -i telegram

# Ver variável de ambiente
echo $TELEGRAM_BOT_TOKEN
```

### 2. Gerar Novo Token no BotFather

1. Abra o Telegram e procure por **@BotFather**
2. Envie `/mybots`
3. Selecione seu bot
4. Clique em **API Token**
5. Se precisar, clique em **Revoke current token** e gere novo

### 3. Configurar Token Correto

```bash
# Via variável de ambiente
export TELEGRAM_BOT_TOKEN="123456789:ABCdefGHIjklMNOpqrsTUVwxyz"

# Adicionar no .bashrc ou .zshrc
echo 'export TELEGRAM_BOT_TOKEN="seu_token_aqui"' >> ~/.bashrc
source ~/.bashrc
```

```yaml
# Ou no arquivo de configuração
telegram:
  bot_token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
```

### 4. Verificar Formato do Token

O token do Telegram tem o formato:
```
<bot_id>:<hash>
Exemplo: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
```

- Primeira parte: números (ID do bot)
- Dois pontos (:) separando
- Segunda parte: letras e números (35 caracteres aprox.)

### 5. Testar Token Manualmente

```bash
# Testar se o token é válido
curl "https://api.telegram.org/bot<SEU_TOKEN>/getMe"

# Resposta esperada (sucesso):
# {"ok":true,"result":{"id":123456789,"is_bot":true,...}}

# Resposta de erro:
# {"ok":false,"error_code":401,"description":"Unauthorized"}
```

### 6. Verificar Arquivo de Configuração

```bash
# Ver se o arquivo existe e está legível
cat ~/.openclaw/config.yaml

# Verificar se não há espaços ou caracteres invisíveis
cat -A ~/.openclaw/config.yaml | grep telegram
```

## Problemas Relacionados

- [Bot Não Responde](#)
- [Erro de Webhook Telegram](#)
- [Configuração Inválida](#)

## Prevenção

- Guarde o token em local seguro
- Use variáveis de ambiente em produção
- Nunca compartilhe o token publicamente
- Revogue e gere novo token se vazar