← 返回 Skills 市场
Telegram MTPROTO CLI
作者
cyberash-dev
· GitHub ↗
· v0.1.4
593
总下载
0
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install tg-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...
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install tg-mtproto-cli - 安装完成后，直接呼叫该 Skill 的名称或使用
/tg-mtproto-cli触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 593 次。
如何安装 Telegram MTPROTO CLI？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install tg-mtproto-cli」即可一键安装，无需额外配置。
Telegram MTPROTO CLI 是免费的吗？
是的，Telegram MTPROTO CLI 完全免费（开源免费），可自由下载、安装和使用。
Telegram MTPROTO CLI 支持哪些平台？
Telegram MTPROTO CLI 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Telegram MTPROTO CLI？
由 cyberash-dev（@cyberash-dev）开发并维护，当前版本 v0.1.4。
推荐 Skills