← Back to Skills Marketplace
Telegram MTPROTO CLI
by
cyberash-dev
· GitHub ↗
· v0.1.4
593
Downloads
0
Stars
0
Active Installs
5
Versions
Install in OpenClaw
/install tg-mtproto-cli
Description
Read-only Telegram CLI via MTProto. Lists chats, fetches messages, downloads media, manages local accounts/sessions. Does not send messages or modify Telegra...
Usage Guidance
This skill appears to do what it says: it uses an npm-published CLI for read-only access to Telegram via MTProto. Before installing, verify the npm package and GitHub repo (maintainer reputation, recent commits, issues), be aware that 'npm install -g' runs third-party code, and only enter your Telegram api_id/api_hash and phone OTP interactively when you trust the environment. Protect the session files (~/.tg-mtproto-cli/sessions/) and the system keychain entries; consider using an account with limited access if you want to reduce risk. If you are uncomfortable installing global npm packages or allowing the agent to run installed CLIs autonomously, do not install or restrict agent invocation.
Capability Analysis
Type: OpenClaw Skill
Name: tg-mtproto-cli
Version: 0.1.4
The skill is explicitly designed as 'read-only' for Telegram data, with strong guardrails against modifying Telegram content or exposing sensitive information. It uses secure credential handling (system keychain, interactive prompts, no persistence for OTP) and explicitly denies 'shell' and 'browser' runtime permissions, significantly limiting its attack surface. File system access is restricted to session files and user-specified download directories. There is no evidence of data exfiltration, malicious execution, persistence, obfuscation, or prompt injection attempts to subvert the agent's purpose.
Capability Assessment
Purpose & Capability
Name/description, required credentials (api_id/api_hash, phone/OTP), and runtime filesystem/network access (session files, media downloads, outbound TCP to Telegram DCs) all align with a read-only MTProto CLI. No unrelated credentials, binaries, or paths are requested.
Instruction Scope
SKILL.md instructs only how to install and use the 'tg' CLI and how to authenticate interactively. It does not ask the agent to read unrelated files, exfiltrate data to third parties, or perform write operations on Telegram. It explicitly warns about sensitive session files and not logging credentials.
Install Mechanism
Install is an npm global package (npm install -g tg-mtproto-cli) with a GitHub repo listed — this is expected for a CLI published on npm but is a moderate-risk install vector because npm package installs run third-party code. No arbitrary URL downloads or extract steps are present.
Credentials
Requested credentials are limited to Telegram API credentials and phone/OTP (interactive). Storage in system keychain and session files is appropriate for the stated functionality. No unrelated environment variables or secrets are requested.
Persistence & Privilege
Skill is instruction-only and not always:true; it does not request persistent system-wide privileges or modify other skills. The default platform ability for agents to invoke skills autonomously remains in place, which is normal and not a concern given the other checks.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tg-mtproto-cli - After installation, invoke the skill by name or use
/tg-mtproto-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.4
tg-mtproto-cli 0.1.4 — No changes detected in this version.
- No file or documentation changes were detected between versions.
- Functionality and skill instructions remain unchanged.
v0.1.3
- Enhanced skill manifest structure in SKILL.md with explicit metadata fields (e.g., description, required_binaries, credentials, runtime_permissions).
- Retained all functional and usage documentation for the CLI, but separated essential requirements and permissions in structured YAML frontmatter.
- No changes to CLI commands or usage details; this update is focused on metadata clarity and compliance.
v0.1.2
- Added explicit source links for both npm and GitHub in the install section.
- Clarified `verify after install` instructions, including `npm ls -g tg-mtproto-cli`.
- Updated guardrails to explicitly state the CLI is read-only by design, detailing all write actions are local-only.
- Enhanced details on session file sensitivity and the interactive nature of `tg auth`.
- No changes to commands, JSON schema, or workflows.
v0.1.1
**Expanded documentation and clarified requirements for tg-mtproto-cli:**
- Added details on required CLI binaries (`tg`, `jq`) and where to obtain them.
- Explained credentials storage, keychain usage, session files, and interactive authentication flow.
- Documented network/file access and security guardrails; clarified read-only limitations and filesystem writes.
- Outlined resource usage: session file locations, keychain access, and media download behavior.
- Added troubleshooting steps, credential handling notes, and clear install/version check instructions.
- Kept user command references, JSON schemas, and workflows with improved context.
v0.1.0
Initial release of tg-mtproto-cli: Telegram CLI via MTProto
- Provides a command-line interface for accessing Telegram data directly with MTProto, avoiding Bot API limits.
- Supports authentication and multi-account management, including account listing, renaming, and setting defaults.
- Enables listing chats, reading messages (with date and forum topic filtering), listing forum topics, and downloading media by message ID.
- Structured JSON output supported for all commands, with schemas provided for message data.
- Includes sample workflows for scripting, such as filtering messages, downloading media, and handling forum topics.
- Documents troubleshooting, chat identification formats, and exit codes for easier usage.
Metadata
Frequently Asked Questions
What is Telegram MTPROTO CLI?
Read-only Telegram CLI via MTProto. Lists chats, fetches messages, downloads media, manages local accounts/sessions. Does not send messages or modify Telegra... It is an AI Agent Skill for Claude Code / OpenClaw, with 593 downloads so far.
How do I install Telegram MTPROTO CLI?
Run "/install tg-mtproto-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Telegram MTPROTO CLI free?
Yes, Telegram MTPROTO CLI is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Telegram MTPROTO CLI support?
Telegram MTPROTO CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Telegram MTPROTO CLI?
It is built and maintained by cyberash-dev (@cyberash-dev); the current version is v0.1.4.
More Skills