A high-performance command-line interface for reading, searching, and sending Telegram messages and managing group contacts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tg
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tg using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Telegram CLI Skill?
The Telegram CLI skill is a specialized tool designed to bring full messaging functionality directly into the developer's terminal. As part of the Openclaw Skills ecosystem, it allows for seamless interaction with the Telegram API, enabling users to manage their inbox, search through vast chat histories, and send messages without switching contexts. It is built for speed and efficiency, providing a text-based alternative to the standard GUI clients.
This skill is particularly valuable for developers who want to integrate messaging into their automation pipelines or for those who prefer a keyboard-centric workflow. By leveraging this tool, you can programmatically interact with your Telegram account, making it an essential component for modern communication management within technical environments.
Telegram CLI Skill Use Cases
- Monitoring unread messages and inbox summaries via the terminal
- Performing deep keyword searches across all chats or specific groups
- Sending direct messages and group replies using shell commands
- Retrieving contact information and group member lists for administrative tasks
- Automating message retrieval based on specific timeframes like the last hour
How Telegram CLI Skill Works
- The user installs the CLI utility globally on their system using a package manager.
- An initial authentication process is performed where the user links their Telegram account via API credentials.
- Reading commands are used to query the Telegram servers for message history, chat lists, or unread notifications.
- Writing commands allow the user to transmit text data to specific users or group IDs.
- The tool processes requests and can return data in either human-readable text or structured JSON for further script integration.
Telegram CLI Skill Setup
To integrate this with your Openclaw Skills setup, first install the package:
npm install -g @cyberdrk/tg
You must then authenticate with your API credentials from the Telegram apps portal:
tg auth
Verify your session status at any time using:
tg check
Telegram CLI Skill Data Schema & Taxonomy
The skill organizes Telegram data into structured objects, especially when using the --json flag. The metadata taxonomy includes:
| Data Type | Description | Key Attributes |
|---|---|---|
| Message | Individual chat entries | id, sender, text, timestamp |
| Chat | Dialogues and Groups | name, id, unread_count |
| User | Contact information | @username, id, admin_status |
| Search Result | Query matches | chat_name, message_content, date |
Telegram CLI Skill Advanced Features
- Time-relative filtering using the --since flag for precise message retrieval
- Partial name matching for chats, allowing for shorter command entry
- Full JSON output support for every command to enable multi-agent automation
- Administrative tools to list group admins and members directly
- Support for message IDs to facilitate precise threaded replies
SKILL.md
Loading
Related Openclaw Skills
Onchain CLI
A comprehensive command-line interface for tracking cryptocurrency portfolios, exchange history, and prediction markets across multiple blockchains.
Onchain CLI
A versatile command-line tool for tracking cross-chain crypto portfolios, exchange balances, and prediction markets integrated with Openclaw Skills.
gram
A powerful Instagram CLI for viewing feeds, profiles, and engaging with content directly from your terminal.
Travel Concierge
An AI-driven CLI tool that extracts direct contact information from travel listings and places autonomous booking calls.
Telegram Group Chat Setup
Automate the complex configuration required to deploy and manage MoltBot agents within Telegram group chat environments.
Grok Research
A specialized research skill that forwards queries to the Grok API for real-time crypto sentiment and Twitter narrative analysis.