Telegram Bot Integration: Alertas e Controle do OpenClaw

Telegram é o canal mais comum pra alertas de trading bot. Push notifications confiáveis, fácil setup, multi-device. Este guia cobre integração com OpenClaw.

Por que Telegram

• Push notifications instantâneas e confiáveis
• Bots oficiais do Telegram são triviais de criar (BotFather)
• Multi-device (mobile + desktop)
• Histórico searchable
• Free

Passo 1 — Criar bot no Telegram

1. Chat com @BotFather
2. /newbot
3. Escolha nome (ex: "Meu OpenClaw Bot") e username (deve terminar em "bot")
4. Copie o token retornado (algo como 1234567:ABC-DEF...)

Passo 2 — Encontrar seu chat_id

1. Inicie chat com seu bot novo (clique no link, mande "/start")
2. Visite: https://api.telegram.org/bot<TOKEN>/getUpdates
3. Veja "chat":{"id":} — esse é seu chat_id

Passo 3 — Setup skill OpenClaw

openclaw skill install @openclaw/skill-telegram

Config:

# ~/.openclaw/config.yml
telegram:
  bot_token: "${TELEGRAM_BOT_TOKEN}"
  chat_id: "${TELEGRAM_CHAT_ID}"
  rate_limit: "30/min"

Passo 4 — Alertas padrão

Configure alerts pra eventos importantes:

• Bot started/stopped
• Ordem placed/filled/canceled
• Erros de API
• Daily PnL summary
• Drawdown approaching limit
• Kill switch triggered
• Saldo baixo no wallet

Severity levels:

• 🟢 Info — trade routine
• 🟡 Warning — approaching limit, retry happening
• 🔴 Critical — kill switch, large loss, API down

Passo 5 — Bot commands

Bot bidirecional: você pode comandar via Telegram.

/status        — saldo atual, posições, PnL hoje
/positions     — lista posições abertas
/pnl           — PnL último 7 dias
/pause         — pausa novo trades (mantém existentes)
/resume        — retoma trading
/killswitch    — fecha tudo, para tudo (emergency)
/balance       — saldos por exchange

Segurança

• Chat_id whitelist: bot só responde ao seu chat_id, ignore outros
• Commands sensíveis (killswitch) requerem confirmação ("Tem certeza? Sim/Não")
• Rate limit nas commands pra prevenir bug loop
• Token não vaze: usuário com token controla bot. Trate como senha.

Telegram channels vs DMs

• DM direto: notificações pessoais, comandos privados
• Channel privado: log de trades acessível em vários devices
• Group privado: compartilha com pessoas confiáveis (ex: parceiro de negócio)

Padrões de mensagem boas

Use formatação Markdown:

🟢 *Trade executado*
Symbol: BTC/USDT
Side: BUY
Qty: 0.01 BTC
Price: $48,250
PnL impact: -$2.41 (fees)

Clean, scannable em 2 segundos.

Combinando com outros canais

• Telegram: real-time + commands
• Email: daily summary
• Dashboard web: deep analysis

Cada canal pra sua função. Telegram não substitui dashboard pra análise.

Veja: checklist de hardening (item: monitoring). 🦞