← Back to Skills Marketplace
Telegram Telethon CLI
by
youziyouzishu
· GitHub ↗
· v1.0.0
· MIT-0
114
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install telegram-telethon
Description
Manage Telegram via tgctl-telethon CLI (Python/Telethon) - send/forward/edit/delete/pin messages, search, list chats/members, join/leave groups, kick/invite...
Usage Guidance
Do not install this package yet. The installer references a 'tgctl' script that is not included in the package — without that file you cannot verify what will run. Before proceeding, ask the publisher for the missing tgctl source (or a trusted upstream repository) and review it for network endpoints and sensitive operations. Confirm the registry metadata is updated to declare the required TELEGRAM_API_ID and TELEGRAM_API_HASH and the session path (~/.tgctl-telethon/). If you must test, run the installer in an isolated environment (container or disposable VM), inspect the created wrapper and the tgctl script, and verify that network calls go only to Telegram's official endpoints. Remember: this tool performs account-level actions (send/delete/kick/etc.), so a malicious or tampered tgctl could operate as your Telegram user — only install if you can review the executable source or trust the package origin.
Capability Analysis
Type: OpenClaw Skill
Name: telegram-telethon
Version: 1.0.0
The telegram-telethon skill bundle provides a legitimate interface for managing Telegram accounts via the Telethon library. The install.sh script follows standard practices by creating a Python virtual environment and installing the official 'telethon' package. The SKILL.md documentation includes helpful security guidance, such as instructing the agent to avoid sending authentication codes over Telegram and requiring user-provided API credentials. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
SKILL.md describes a Telethon-based tgctl CLI that requires TELEGRAM_API_ID and TELEGRAM_API_HASH and creates local session files. The registry metadata, however, declares no required env vars or config paths. The install script expects a local 'tgctl' script to be bundled, but that script is not present in the manifest. This inconsistency (missing executable and omitted env vars) does not align with the claimed purpose.
Instruction Scope
The runtime instructions are narrow and appropriate for a user-account Telegram CLI: install, set TELEGRAM_API_ID/HASH, login interactively, and store sessions locally. The SKILL.md does not instruct the agent to read unrelated system files or send data to unexpected endpoints. However, because the actual 'tgctl' implementation is not included, we cannot verify that its runtime behavior stays within the documented scope.
Install Mechanism
The included installer is a local shell script that creates a per-user venv and pip-installs Telethon (from PyPI), then writes a wrapper into ~/.local/bin. Installing Telethon via pip is expected for a Python tool. There is no external arbitrary binary download. Risk is moderate because pip install executes code from PyPI and the main tool ('tgctl') referenced by the installer is missing from the package.
Credentials
The SKILL.md requires TELEGRAM_API_ID and TELEGRAM_API_HASH and stores sessions under ~/.tgctl-telethon/, but the skill metadata lists zero required env vars and no config paths. Declaring no primary credential while the CLI needs API credentials is a clear mismatch. The env access requested by the instructions (API_ID/HASH, session files) is reasonable for the stated functionality, but the registry/package should declare them.
Persistence & Privilege
The skill does not request always: true and does not modify other skills or system-wide configs. The installer writes files under the user's home (~/.local/bin, ~/.tgctl-telethon-venv, and session directory), which is normal for a per-user CLI tool.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install telegram-telethon - After installation, invoke the skill by name or use
/telegram-telethon - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Python/Telethon-based Telegram CLI with 35 commands
Metadata
Frequently Asked Questions
What is Telegram Telethon CLI?
Manage Telegram via tgctl-telethon CLI (Python/Telethon) - send/forward/edit/delete/pin messages, search, list chats/members, join/leave groups, kick/invite... It is an AI Agent Skill for Claude Code / OpenClaw, with 114 downloads so far.
How do I install Telegram Telethon CLI?
Run "/install telegram-telethon" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Telegram Telethon CLI free?
Yes, Telegram Telethon CLI is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Telegram Telethon CLI support?
Telegram Telethon CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Telegram Telethon CLI?
It is built and maintained by youziyouzishu (@youziyouzishu); the current version is v1.0.0.
More Skills