← Back to Skills Marketplace
224
Downloads
0
Stars
1
Active Installs
6
Versions
Install in OpenClaw
/install telegram-cli
Description
CLI tool for Telegram via MTProto. Send/read messages, manage groups, search conversations, download media, and automate Telegram workflows. Use when the tas...
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install telegram-cli - After installation, invoke the skill by name or use
/telegram-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 224 downloads so far.
How do I install Telegram cli?
Run "/install telegram-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Telegram cli free?
Yes, Telegram cli is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Telegram cli support?
Telegram cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Telegram cli?
It is built and maintained by baontq23 (@baontq23); the current version is v1.0.5.
More Skills