Telegram

---

name: telegram description: OpenClaw skill for designing Telegram Bot API workflows and command-driven conversations using direct HTTPS requests (no SDKs).

---

Telegram Bot Skill (Advanced)

Purpose

Provide a clean, production-oriented guide for building Telegram bot workflows via the Bot API, focusing on command UX, update handling, and safe operations using plain HTTPS.

Best fit

You want a command-first bot that behaves professionally.

You need a reliable update flow (webhook or polling).

You prefer direct HTTP calls instead of libraries.

Not a fit

You require a full SDK or framework integration.

You need complex media uploads and streaming in-process.

Quick orientation

Read references/telegram-bot-api.md for endpoints, update types, and request patterns.

Read references/telegram-commands-playbook.md for command UX and messaging style.

Read references/telegram-update-routing.md for update normalization and routing rules.

Read references/telegram-request-templates.md for HTTP payload templates.

Keep this SKILL.md short and use references for details.

Required inputs

Bot token and base API URL.

Update strategy: webhook or long polling.

Command list and conversation tone.

Allowed update types and rate-limit posture.

Expected output

A clear command design, update flow plan, and operational checklist.

Operational notes

Prefer strict command routing: /start, /help, /settings, /status.

Always validate incoming update payloads and chat context.

Handle 429s with backoff and avoid message bursts.

Security notes

Never log tokens.

Use webhooks with a secret token header when possible.