openclaw
Version:
Multi-channel AI gateway with extensible messaging integrations
46 lines (34 loc) • 2.19 kB
Markdown
# Telegram
Talk to OpenClaw through a Telegram bot in direct messages, groups, channels, and
topics. The plugin supports media, voice notes, reactions, polls, and native
commands.
## Get started
Create a bot with **@BotFather**, then add Telegram using `openclaw channels add`
and provide the bot token. Verify the connection with
`openclaw channels status --probe`.
Send your bot a message, then approve the resulting pairing request. Group
access uses separate allowlists and mention settings; configure these before
using the bot in a group.
Follow the [Telegram setup guide](https://docs.openclaw.ai/channels/telegram/setup)
for bot creation, pairing, and group permissions.
## Upgrade legacy ingress state
Update-time Doctor and startup migration import remaining
`telegram/ingress-spool-<account>/*.json` and `.json.processing` files into SQLite
ingress. Pending updates retain their payload and receipt timestamp; old process
claims return to pending replay. `.json.failed` files remain failed tombstones
with their original failure time and are never automatically replayed.
Doctor backs up exact source bytes as `.migrated` files before normalization.
Import receipts prevent duplicate replay after an interrupted cleanup, including
after the corresponding queue rows have been consumed or pruned. Conflicting or
malformed sources remain intact with a diagnostic; resolve the reported conflict
and run `openclaw doctor --fix`. Keep the backups for recovery.
Verified cleanup-only failures warn without blocking an upgrade.
Plugin developers can follow the
[Doctor ingress migration contract](https://docs.openclaw.ai/plugins/sdk-migration/how-to-migrate#migrate-durable-ingress-files-through-doctor).
## Retired JSON sidecars
Bot-info, sticker, thread-binding, update-offset, message, sent-message, and
topic-name JSON sidecars from before July 2026 are no longer inspected or
archived by Doctor. The files remain untouched. If they contain state you
still need, restore a complete pre-update backup, run `openclaw doctor --fix`
with OpenClaw 2026.9.5, then update again. See
[older-version upgrades](https://docs.openclaw.ai/install/updating#upgrading-very-old-versions).