2.9k Downloads
Overview
Command-line interface for interacting with a Telegram account (reading, searching, and sending messages, plus basic account, contact, and group info), with JSON output suitable for automated agents.
Key Advantages
1.Covers the main Telegram workflows: inbox overview, reading chats, search across/all chats, sending and replying to messages.
2.All commands support a --json flag, making it well-suited for programmatic use and structured parsing by agents.
3.Includes group- and contact-related utilities (members, admins, contact info, groups where user is admin).
4.Simple, Unix-style CLI with clear, composable commands, arguments, and flags (--since, -n, --all, --chat).
5.Uses official Telegram API credentials (via my.telegram.org/apps) rather than scraping, which is typically more robust and compliant.
Use Cases
- Check unread Telegram messages or get an inbox summary for a user.
- Read recent messages from a specific chat or DM, optionally with time or count limits (e.g., last 50 messages or last hour).
- Search within a specific chat or across all chats for particular topics, keywords, or entities.
- Send Telegram messages to users, groups, or channels, including replying to specific message IDs.
- Look up information about a Telegram contact by username, including for follow-up interactions or verification steps by an agent. List members or admins of a group to enable governance, moderation, or
Evaluation Scores
8.3
/ 10
Reliability
7.5
Functionality
8.8
Usability
9.1
Safety
7.8
Performance
8.0
Compatibility
8.2
Based on 1 evaluation · Latest: 3/19/2026
Download Trend
Loading...
Evaluation History (1)
8.3/103/19/2026▼
OS: darwin-x64LLM: openai/gpt-5-nano
**Overall**: Solid Telegram CLI well-suited for agent integration. It exposes the core messaging, search, and group/contact operations and supports JSON output on all commands, which is ideal for OpenClaw workflows.
**Recommended scenarios**
- When the user explicitly wants to **check or read Telegram messages**, including unread/inbox summaries.
- When the user asks to **search Telegram chats** for past information (topics, links, decisions, etc.).
- When the user asks to **send or reply to a Telegram message** to a specific user, group, or channel.
- When the user needs **group/contact context** (members, admins, contact info, list of groups where they are admin).
**Key strengths**
- Comprehensive coverage of everyday Telegram operations: inbox, chats, read, search, send, reply, contacts, group members/admins, and session status.
- Uniform `--json` output makes it easy and reliable for an LLM agent to parse and reason about results.
- Clear, composable CLI interface with time and count filters (e.g., `-n 50`, `--since "1h"`).
**Risks & caveats**
- **Partial chat name matching** (e.g., "MetaDAO" matching "MetaDAO Community") can cause the agent to select the wrong chat when sending messages; agents should cross-check chat IDs/names from `tg chats --json` before sending.
- Requires **Telegram API credentials and local authentication**, which must already be set up for the skill to operate; otherwise commands will fail.
- Reliability and maintenance level are not fully known from the metadata; agents should handle command failures and validate outputs before taking follow-up actions.
Comments (0)
No comments yet. Be the first!