← Back to Skills Marketplace
440
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install tgsearch-telethon
Description
Search public Telegram channels and groups by keyword using an authorized Telethon session, returning up to 50 results as JSON.
Usage Guidance
This skill is internally consistent, but it depends on /usr/local/bin/tg_search and an already-authorized Telethon session on the VPS. Before installing or enabling it: (1) inspect the helper binary (/usr/local/bin/tg_search) to confirm its provenance and behavior; (2) verify what Telethon session files or API keys exist on the host (they will be used by the helper); (3) note the small inconsistencies (skill.json entrypoint is "tg_search" while the repository includes run.py) — ensure the platform will execute the intended wrapper; (4) run the helper in an isolated environment (or review its source) if you cannot fully trust the VPS contents. If you want higher assurance, request the helper's source or replace /usr/local/bin/tg_search with a reviewed implementation.
Capability Analysis
Type: OpenClaw Skill
Name: tgsearch-telethon
Version: 0.1.1
The skill executes an unprovided external binary, `/usr/local/bin/tg_search`, which is described as interacting with an 'already-authorized Telethon session'. While the `run.py` script safely passes arguments to this binary using `subprocess.run` (preventing shell injection), the functionality and security of `/usr/local/bin/tg_search` itself are opaque. This reliance on an unknown, potentially powerful, external component that accesses a sensitive session makes the skill suspicious due to the unanalyzed trust boundary, as seen in `run.py` and `SKILL.md`.
Capability Assessment
Purpose & Capability
The name/description say it will search public Telegram channels via a local Telethon session; the included run.py simply invokes /usr/local/bin/tg_search and returns its JSON — this is consistent with the claimed capability. The skill does require an already-authorized Telethon session and a local helper binary, which is expected for this design.
Instruction Scope
SKILL.md and run.py only run the absolute-path helper (/usr/local/bin/tg_search) with query/limit and relay its JSON output. The instructions do not read arbitrary files or environment variables, but they assume access to a local Telethon session and an external binary which may in turn access sensitive credentials on the VPS.
Install Mechanism
No install spec is provided (instruction-only with a small wrapper run.py). Nothing in the skill writes code to disk or downloads external artifacts as part of installation.
Credentials
The skill requests no environment variables or credentials. However, its operation depends on a pre-existing authorized Telethon session and a system binary; those external items may expose Telegram credentials or session files on the host. That implicit access is proportional to the task but is a sensitive dependency you should verify.
Persistence & Privilege
The skill does not request always:true, does not include an installer that modifies other skills or system-wide settings, and doesn't persist new credentials. It only invokes a local binary at runtime.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tgsearch-telethon - After installation, invoke the skill by name or use
/tgsearch-telethon - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
- Added metadata file (_meta.json) for the skill.
- No changes to code or functionality.
v0.1.0
Initial release of tgsearch-telethon.
- Enables global Telegram search for public channels and groups by keyword.
- Returns up to a specified limit of results in JSON format with channel/group info.
- Requires an already-authorized Telethon session on the VPS.
- Only public, searchable channels and groups are supported; private communities are not included.
Metadata
Frequently Asked Questions
What is Tgsearch Telethon?
Search public Telegram channels and groups by keyword using an authorized Telethon session, returning up to 50 results as JSON. It is an AI Agent Skill for Claude Code / OpenClaw, with 440 downloads so far.
How do I install Tgsearch Telethon?
Run "/install tgsearch-telethon" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tgsearch Telethon free?
Yes, Tgsearch Telethon is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Tgsearch Telethon support?
Tgsearch Telethon is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Tgsearch Telethon?
It is built and maintained by Kirill (@kirillvrnz); the current version is v0.1.1.
More Skills