An automated discovery tool to search and extract metadata from public Telegram channels and groups using Telethon.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tg-search
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-search 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 tg_search?
tg_search is a specialized technical utility designed for the rapid discovery of public communities on the Telegram platform. By leveraging an authorized Telethon session on a VPS, this tool allows AI agents and developers to programmatically scan for public channels and groups based on specific keywords. It serves as a vital bridge for data gathering and community research within the Openclaw Skills ecosystem.
The skill focuses on accessibility and speed, providing structured JSON output that includes channel titles, usernames, and unique IDs. It is particularly effective for users needing to monitor niche topics or identify public hubs for information exchange without manual searching.
tg_search Use Cases
- Automated monitoring of public Telegram communities for specific niche keywords like crypto or AI.
- Gathering public channel metadata for market research or sentiment analysis projects.
- Identifying public support groups or discussion hubs for specific software tools and Openclaw Skills integrations.
- Building automated directory services for public Telegram resources.
How tg_search Works
- The user or agent provides a search query and an optional result limit to the skill.
- The skill executes a localized binary command on the VPS using an active Telethon session.
- The Telethon client performs a global search across Telegram's public index.
- Matching results are filtered for public accessibility (channels and groups).
- The skill parses the raw data into a structured JSON array and returns it to the caller.
tg_search Setup
Ensure you have an active Telethon session authorized on your VPS. The binary must be accessible at the specified system path.
# Verify the installation path
ls /usr/local/bin/tg_search
# Basic usage test
/usr/local/bin/tg_search "ai agents" 5
tg_search Data Schema & Taxonomy
The skill returns a JSON array of objects. Each object represents a discovered Telegram entity with the following schema:
| Key | Type | Description |
|---|---|---|
| type | string | Indicates if the entity is a 'channel' or a 'group' |
| title | string | The display name of the Telegram community |
| username | string | The public @handle (can be null if not set) |
| id | integer | The unique numerical Telegram ID for the entity |
Note: Results are limited to public entities discoverable via global search.
tg_search Advanced Features
- Support for multi-language keyword searching (e.g., Cyrillic, Latin, or Asian scripts).
- Configurable result limits (defaulting to 10, with a maximum cap of 50 per request).
- Direct VPS execution for low-latency search results.
- Seamless integration as a discovery module for complex Openclaw Skills automated workflows.
SKILL.md
Loading
Related Openclaw Skills
Self-Improvement Skill
A specialized framework for AI agents to capture learnings, errors, and feature requests to enable continuous autonomous improvement.
TeamClaw
TeamClaw is a high-performance agent subsystem designed for complex multi-agent orchestration (OASIS), computer use automation, and real-time visual monitoring.
XMindify
XMindify is a powerful AI-driven mind map generator that converts unstructured data into professional XMind and SVG visualizations using the XMindMark syntax.
Tavily Best Practices
A comprehensive guide and toolset for integrating Tavily's real-time web search and research capabilities into production-ready AI agents.
Voice Call
A powerful telephony integration allowing AI agents to initiate, manage, and conclude voice calls through major providers like Twilio and Telnyx.
Memory to Skill Crystallizer
An automated utility that scans memory logs for recurring patterns and crystallizes them into executable local skills.
Featured*
