telegram

Installation
SKILL.md

Telegram Automation with telegram-agent

Telegram CLI for AI agents. Interact with Telegram programmatically — read messages, send messages, search, download media, tag Saved Messages, and more. Operates a real user account via TDLib, not the Bot API.

All output is JSON to stdout in the envelope { ok, data } for success or { ok: false, error, code } for failure. Warnings go to stderr. Prefer jq over python3 for JSON processing.

Setup

If telegram-agent is not installed, read references/installation.md for install instructions, authentication, and troubleshooting.

telegram-agent me   # Verify connection works

A background daemon auto-starts on first command and keeps the TDLib connection alive, making subsequent commands fast (~200 ms vs ~2 s cold).

Commands

Installs
41
GitHub Stars
7
First Seen
May 18, 2026
telegram — beautyfree/telegram-agent