← 返回 Skills 市场
224
总下载
0
收藏
1
当前安装
6
版本数
在 OpenClaw 中安装
/install telegram-cli
功能描述
CLI tool for Telegram via MTProto. Send/read messages, manage groups, search conversations, download media, and automate Telegram workflows. Use when the tas...
安全使用建议
This skill appears consistent with being a helper for the node-telegram-cli npm package, but before installing consider: (1) you will need to provide your Telegram phone number and OTP — this grants the CLI access to your account, so only use it if you trust the package and owner; (2) verify the npm package and GitHub repo are genuine and actively maintained (check publisher, recent commits, and issues); (3) downloaded media are saved to ~/.telegram-cli/downloads/ — review and clean that directory if needed; (4) the tool can send messages and manage groups, so be careful when automating actions (limit automation scope and confirm commands before running); (5) the CLI stores session data in the OS keychain — ensure you are comfortable with that storage and revoke sessions from Telegram if you suspect misuse. If you need higher assurance, inspect the npm package source locally before installing or run it in an isolated environment.
功能分析
Type: OpenClaw Skill
Name: telegram-cli
Version: 1.0.5
The skill bundle provides a comprehensive interface for the 'node-telegram-cli' tool, allowing an AI agent to interact with Telegram via MTProto. The instructions in SKILL.md are well-structured for automation, emphasizing JSON output and secure credential storage via the OS Keychain. No indicators of malicious intent, data exfiltration, or prompt injection were found; the tool's capabilities (messaging, media handling, and group management) are consistent with its stated purpose as a CLI for Telegram.
能力评估
Purpose & Capability
The name/description match the SKILL.md: it documents the node-telegram-cli npm package and CLI commands for reading/sending messages, managing groups, and downloading media. No unrelated binaries, cloud credentials, or unexpected capabilities are requested.
Instruction Scope
The instructions stay within scope: they instruct installing the npm package, running an interactive login (phone + OTP), and using CLI commands (read/write) with a required --json flag for automation. Notes of interest: session persistence is documented and downloaded media are stored in ~/.telegram-cli/downloads/. The SKILL.md does not instruct reading unrelated system files or exfiltrating data to external endpoints.
Install Mechanism
No install spec in the skill bundle (instruction-only). The SKILL.md recommends installing from npm (npm install -g node-telegram-cli) and references the package and GitHub repo — a standard, traceable public registry installation path.
Credentials
The skill declares no required environment variables or external credentials beyond the Telegram account login (phone + OTP). It states credentials are stored in the OS keychain, which is proportional for a user-level client.
Persistence & Privilege
The skill does not request always:true and is user-invocable. It documents persistent session behavior (session stays logged in until ntg logout) and a local download directory; these are ordinary for a CLI that manages an account, but users should be aware of the persistent session and where files are saved.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install telegram-cli - 安装完成后，直接呼叫该 Skill 的名称或使用
/telegram-cli触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.5
- Documentation restructured and condensed for clarity and easier reference.
- Added explicit sections for command usage, peer formats, group/contact management, and JSON output schemas.
- Security/storage approach is now clearly summarized at the top.
- All examples and descriptions reinforce the requirement to use the `--json` flag for automation.
- Interactive/unsafe commands (e.g., `ntg chat`) are clearly marked as unsuitable for AI/automation.
- No functional or code changes detected; this is a documentation-focused update.
v1.0.4
- Added npm publication info and provenance badge to documentation.
- Documented support for sending messages silently using the `--silent` flag.
- No functional or command changes; documentation improvements only.
v1.0.3
- Minor documentation updates clarifying that API credentials and session token are stored via the OS Keychain.
- Reworded security notes for clarity.
- No code or feature changes detected.
v1.0.2
**Security improvement: Credentials now stored in OS Keychain**
- API credentials and session tokens are now securely stored in the OS Keychain (macOS Keychain, Windows Credential Manager, or Linux Secret Service)
- Updated documentation to clarify credentials storage and fallback to file mode (with a warning) for systems without a keychain
- Added repository link to the skill guide
- Clarified that the config file only stores non-sensitive settings
v1.0.1
- Improved JSON output schemas: added fields (`lastMessageId`, `mediaType`) and detailed `inbox --chat` output.
- Updated media download commands: `ntg download <id> --chat <peer>` now required; introduced `ntg view` and `ntg clean-downloads`.
- Documented media file formats and handling, including file locations and cleanup.
- Clarified usage of message IDs and media types for accurate automation.
- Expanded AI agent workflow examples to cover media download and management.
v1.0.0
Initial release of the telegram-cli (node-telegram-cli) skill.
- Provides a CLI tool for Telegram via MTProto, enabling programmatic messaging, group management, media handling, and search.
- Includes dedicated JSON output for all commands (`--json` flag) for machine-readability and AI agent compatibility.
- Supports both read (listing/searching chats, messages, group info) and write (sending messages, forwarding, deleting, media operations) operations.
- Offers group management commands: create group, add/remove users, rename, set photo.
- Session is managed interactively with `ntg login`, and persists until `ntg logout`.
- Includes clear instructions, JSON schema, peer formats, command reference, error handling, and example AI agent workflows.
元数据
常见问题
Telegram cli 是什么？
CLI tool for Telegram via MTProto. Send/read messages, manage groups, search conversations, download media, and automate Telegram workflows. Use when the tas... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 224 次。
如何安装 Telegram cli？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install telegram-cli」即可一键安装，无需额外配置。
Telegram cli 是免费的吗？
是的，Telegram cli 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Telegram cli 支持哪些平台？
Telegram cli 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Telegram cli？
由 baontq23（@baontq23）开发并维护，当前版本 v1.0.5。
推荐 Skills