tg

What This Skill Does

The Telegram CLI skill acts as a robust interface for interacting with the Telegram messaging platform directly through the OpenClaw AI agent. It allows users to automate communication, retrieve historical message data, search across multiple chats, and manage group information without needing to manually open the Telegram app. By leveraging this tool, the agent can parse messages, summarize unread conversations, and execute commands to send responses, making it an essential utility for users who rely on Telegram for their daily professional or personal communications.

Installation

To install the skill, you have two primary options. You can use the global npm package: npm install -g @cyberdrk/tg. Alternatively, for contributors, you can clone the source repository: cd ~/Code/cyberdrk305/telegram && npm install && npm run build && npm link. Once installed, you must authenticate by running tg auth and providing the necessary API credentials obtained from your developer dashboard at my.telegram.org.

Use Cases

This skill is designed for high-efficiency communication tasks. It is ideal for users who need to monitor multiple group chats, track unread notifications, or search through vast chat histories for specific keywords. It works exceptionally well in automated workflows where the AI agent is tasked with summarizing daily group discussions, identifying urgent mentions, or interacting with specific users via direct message. It also serves as a diagnostic tool for managing group memberships and administrative tasks.

Example Prompts

1. "OpenClaw, check my Telegram inbox and summarize any unread messages from the MetaDAO group."
2. "Search for the keyword 'futarchy' in my recent chats and tell me what the latest discussion has been about."
3. "Send a message to @username saying that I am currently unavailable and will respond to them later this afternoon."

Tips & Limitations

• Partial Matching: The CLI supports partial matching for chat names, so searching for 'MetaDAO' will return relevant results even if the group is named 'MetaDAO Community'.
• JSON Output: For advanced users or building additional automations, append the --json flag to any command to receive machine-readable data.
• Authentication: Ensure your API credentials are kept secure, as they provide full read/write access to your Telegram account.
• Time Sensitivity: The --since flag is highly useful for narrowing down noise; use it to filter messages from the 'last 1h' or 'last 7d' to keep the context window manageable for the AI.