tgTelegram CLI for reading, searching, and sending messages. Use when the user asks about Telegram messages, wants to check inbox, search chats, send messages, or look up contacts and groups.
Install via ClawdBot CLI:
clawdbot install arein/tgFast Telegram CLI for reading, searching, and sending messages.
Use this skill when the user:
npm install -g @cyberdrk/tg
Or from source:
cd ~/Code/cyberdrk305/telegram && npm install && npm run build && npm link
First-time setup requires API credentials from https://my.telegram.org/apps
tg auth
tg inbox # Unread messages summary
tg chats # List all chats
tg read "ChatName" -n 50 # Read last 50 messages
tg read "ChatName" --since "1h" # Messages from last hour
tg read @username -n 20 # Read DM with user
tg search "query" --chat "ChatName" # Search within chat
tg search "query" --all # Search all chats
tg send @username "message" # Send DM
tg send "GroupName" "message" # Send to group
tg reply "ChatName" 12345 "response" # Reply to message ID
tg contact @username # Get contact info
tg members "GroupName" # List group members
tg admins "GroupName" # List admins only
tg groups --admin # Groups where you're admin
tg whoami # Show logged-in account
tg check # Verify session
All commands support --json for structured output suitable for processing:
tg inbox --json # JSON format
tg read "Chat" --json # JSON with messages array
tg chats --json # JSON with chat list
Check inbox:
tg inbox
Read recent messages from a chat:
tg read "MetaDAO Community" -n 20
Search for a topic:
tg search "futarchy" --chat "MetaDAO"
Send a message:
tg send @username "Hello, checking in!"
--since flag accepts formats like "1h", "30m", "7d"Generated Mar 1, 2026
Community managers can use this CLI to quickly check unread messages across multiple Telegram groups, search for specific topics or keywords within community chats, and respond to important messages. This enables efficient moderation and engagement without needing to open the full Telegram app interface.
Support teams can monitor customer inquiries in Telegram channels, search for previous conversations with specific users, and send standardized responses. The JSON output capability allows integration with ticketing systems to automatically log and categorize support requests.
Researchers can search across multiple Telegram channels for specific keywords related to products, brands, or trends, then export structured JSON data for analysis. This enables tracking of public sentiment, identifying emerging topics, and monitoring competitor discussions in real-time.
Development teams can automate notifications, send status updates to project channels, and search for technical discussions across team chats. The CLI allows integration with CI/CD pipelines to send deployment notifications and monitor development discussions programmatically.
Content creators and influencers can efficiently manage their Telegram communities by checking unread messages, searching for fan questions, and sending broadcast messages to multiple channels. The partial chat name matching makes it easy to interact with large community groups quickly.
Offer a managed version of the CLI tool with enhanced features like scheduled message sending, advanced analytics dashboard, and team collaboration features. Charge monthly subscriptions based on usage tiers and number of Telegram accounts managed.
Provide custom integration services for businesses wanting to connect Telegram with their existing CRM, support, or analytics systems. Offer consulting, custom development, and ongoing maintenance contracts for large organizations with complex workflow requirements.
Create a hosted API service that wraps the CLI functionality, allowing developers to integrate Telegram operations into their applications without managing authentication or CLI installations. Charge based on API call volume and data processing requirements.
💬 Integration Tip
Use the --json flag consistently for all commands to ensure structured output that can be easily parsed and integrated with other tools through scripts or APIs.
iMessage/SMS CLI for listing chats, history, watch, and sending.
Use when you need to control Discord from Clawdbot via the discord tool: send messages, react, post or upload stickers, upload emojis, run polls, manage threads/pins/search, fetch permissions or member/role/channel info, or handle moderation actions in Discord DMs or channels.
Use when you need to control Slack from Clawdbot via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
Build or update the BlueBubbles external channel plugin for Clawdbot (extension package, REST send/probe, webhook inbound).
OpenClaw skill for designing Telegram Bot API workflows and command-driven conversations using direct HTTPS requests (no SDKs).