← 返回 Skills 市场
Telegram Channel Reader
作者
Sergey Mikhaylov
· GitHub ↗
· v0.9.2
966
总下载
0
收藏
1
当前安装
30
版本数
在 OpenClaw 中安装
/install sergei-mikhailov-tg-channel-reader
功能描述
Read posts and comments from Telegram channels via MTProto (Pyrogram or Telethon). Fetch recent messages and discussion replies from public or private channe...
安全使用建议
This skill is coherent with its description: it needs your TG_API_ID and TG_API_HASH and will create/read a session file that gives full access to the Telegram account you authenticate. Before installing: (1) be prepared to keep the session file and TG_API_HASH secret (store them with proper file permissions or a keychain), (2) review where session and state files will live (defaults in your home directory) and consider a dedicated isolated account if you are concerned about automated access, and (3) note that the SKILL.md/docs reference optional env vars/config files (TG_SESSION, TG_USE_TELETHON, TG_READ_UNREAD, TG_STATE_FILE); ensure you understand and set them explicitly if you want non-default behavior. If you need stronger assurance, inspect setup-tg-reader.sh and the CLI entrypoint code (reader.py / reader_telethon.py) yourself before running the setup script or running auth.
功能分析
Type: OpenClaw Skill
Name: sergei-mikhailov-tg-channel-reader
Version: 0.9.2
The skill is a legitimate Telegram channel reader using MTProto (Pyrogram and Telethon backends). It handles sensitive credentials (API ID/Hash) and session files, but the code and documentation emphasize local storage, user-controlled setup, and security best practices (e.g., using chmod 600). Diagnostic scripts like tg_check.py and setup-tg-reader.sh are well-documented and restricted to the skill's own files, and no evidence of data exfiltration, unauthorized remote execution, or malicious prompt injection was found.
能力评估
Purpose & Capability
Name and description match the code and runtime requirements. The code and entry points implement MTProto access via Pyrogram/Telethon and the declared env vars (TG_API_ID, TG_API_HASH) and required CLI binaries (tg-reader, tg-reader-check) are appropriate for the stated purpose.
Instruction Scope
SKILL.md's instructions stay within the stated purpose (auth, fetch, info, comments). The skill will create and read session files and a state file in the user's home directory (e.g. ~/.tg-reader-session.session, ~/.tg-reader-state.json) which is expected for MTProto clients, and it prints guidance on securing them. Minor issue: SKILL.md and other docs reference optional env vars and config files (TG_SESSION, TG_USE_TELETHON, TG_READ_UNREAD, TG_STATE_FILE, ~/.tg-reader.json, ~/.openclaw/openclaw.json) that are not listed in the frontmatter 'requires.env' list — functionally fine but a metadata/documentation mismatch to be aware of. The code purposely restricts session discovery to known filenames to avoid scanning arbitrary sessions.
Install Mechanism
The package uses local Python entry points and a setup script (pip install / pip editable). There is no remote download from an arbitrary URL in the registry metadata. The included setup script installs dependencies via pip; that is conventional for Python CLI tools. Older versions auto-added exec approvals, but changelog shows that was removed (current script prints approval commands only).
Credentials
The required secrets (TG_API_ID and TG_API_HASH) are appropriate and proportional for MTProto access; TG_API_HASH is correctly flagged as the primary secret. The skill also reads optional env vars and config files (TG_SESSION, TG_USE_TELETHON, TG_READ_UNREAD, TG_STATE_FILE, ~/.tg-reader.json) which are reasonable for configuration, but these additional env/config knobs are not fully reflected in the frontmatter 'requires.env' and should be noted by the user.
Persistence & Privilege
The skill does not request 'always:true' and does not attempt to modify other skills. It writes and reads session and state files in the user's home directory (expected for an MTProto client). Remember: a session file grants full access to the Telegram account — this is an inherent privilege of the functionality, not an unexplained escalation.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install sergei-mikhailov-tg-channel-reader - 安装完成后，直接呼叫该 Skill 的名称或使用
/sergei-mikhailov-tg-channel-reader触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.9.2
sergei-mikhailov-tg-channel-reader 0.9.2
- Added support for enabling read_unread mode via the TG_READ_UNREAD environment variable.
- Documented environment variable overrides for read_unread and state file location (TG_STATE_FILE).
- Minor documentation improvements to clarify setup and configuration options.
v0.9.1
Set correct display name; read_unread mode — only fetch new posts, no --since needed
v0.9.0
Add read_unread mode — only fetch new posts, no --since needed. Enable with read_unread: true in config.
v0.8.12
Security scan fixes round 2: restrict session discovery in reader.py and reader_telethon.py to known names only, restructure README credential examples to recommend ~/.tg-reader.json instead of ~/.bashrc
v0.8.11
Security scan fixes: remove auto-allowlisting from setup script, limit session file discovery to known names, replace insecure credential examples
v0.8.10
sergei-mikhailov-tg-channel-reader v0.8.10
- Added setup-tg-reader.sh script for auto-setup: checks prerequisites, installs dependencies, and handles OpenClaw exec approvals.
- SKILL.md and setup instructions improved for first-time users and clearer troubleshooting.
- Description and documentation clarified support for fetching comments/discussion replies from Telegram posts.
- Setup and approval steps are now prominently documented, with a quick install path.
- Minor metadata, description, and formatting updates for clarity.
v0.8.9
No changes detected in this version.
- Version 0.8.9 was released with no file changes compared to the previous version.
v0.8.8
sergei-mikhailov-tg-channel-reader 0.8.8
- Added CLAUDE.md documentation file.
- Updated CHANGELOG.md, reader.py, reader_telethon.py, and setup.py with minor revisions and improvements.
- No breaking changes to usage or commands.
v0.8.7
- Added section on command execution approvals, guiding users through OpenClaw exec approval workflow.
- Expanded documentation on output formats for info and fetch commands, including sample JSON structures.
- Added --output option to fetch command to write results directly to a file, improving token economy.
- Improved error handling documentation with details on error_type and action fields.
- Updated instructions for saving and tracking output files and Telegram channels.
- Various clarifications and formatting improvements for usability.
v0.8.5
**Adds support for fetching post comments from Telegram channels.**
- New `--comments` flag for `tg-reader fetch` fetches comments on posts (single channel only, fetch limit auto-drops to 30).
- Added comment customization options: `--comment-limit` (number of comments per post) and `--comment-delay` (delay between fetching comments).
- Documentation and help updated to reflect new comment-fetching features.
- Minor fixes and improvements for reliability and documentation clarity.
v0.8.3
- Added --text-only flag to fetch command for skipping posts without text (media-only, no caption).
- Output now includes has_media and media_type fields for each post, indicating presence and type of attached media.
- Documentation updated to clarify that posts with media may include important text (caption) and should not be skipped automatically.
- No changes to setup or authentication procedures.
v0.8.2
- Documentation files updated for clarity and detail (README_TELETHON.md, SKILL.md, TESTING_GUIDE.md, CHANGELOG.md).
- Outdated or redundant documentation removed (CLAUDE.md).
- Minor code and packaging adjustments (debug_auth.py, setup.py).
- No changes to user-facing commands or functionality.
v0.8.1
- Add support for delay between sequential multi-channel fetches (default 10s, configurable with --delay flag)
- Update documentation to reflect multi-channel fetch now includes delay options and describes new fetch behavior
- Improve error handling: `flood_wait` errors with ≤ 60s wait are now automatically retried (longer waits return error with `wait_Ns` action)
- Minor documentation and usage clarifications throughout SKILL.md
v0.8.0
No changes detected in this version.
v0.7.3
sergei-mikhailov-tg-channel-reader 0.7.3
- Initial source release with all core functionality.
- Added main Python modules and command-line utilities for Telegram channel reading.
- Included documentation: CHANGELOG.md, TESTING_GUIDE.md, and backend-specific guides.
- Supports both Pyrogram and Telethon MTProto backends.
- Provides channel info, message fetching, diagnostics, and authentication commands.
- Added basic test and debug utilities for development.
v0.7.2
- Major cleanup: all Python source, test, and documentation files removed.
- Core files like readers, checkers, setup scripts, and guides have been deleted.
- SKILL.md remains, providing high-level documentation only.
- The package no longer includes any executable code or test infrastructure.
v0.7.1
sergei-mikhailov-tg-channel-reader 0.7.1
- Enhanced error handling: fetch/info commands now include `error_type` and `action` fields, with improved actionable guidance for channel errors (e.g., access denied, banned, not found, invite expired, rate limits).
- Updated documentation in SKILL.md to reflect new structured error responses and handling recommendations for agents.
- Minor internal refactoring for clearer error reporting code paths.
- No breaking changes to command-line usage.
v0.7.0
**v0.7.0 introduces a new pre-flight diagnostic tool and improves reliability.**
- Added a new `tg-reader-check` command for fast, offline diagnostics of credentials, session file, and MTProto backend availability.
- Updated documentation with a simplified, step-by-step “Quick Start” and clearer troubleshooting.
- Improved skill metadata to include `tg-reader-check` as a required binary.
- Enhanced error and session handling guidance throughout the documentation.
- Refined setup, usage instructions, and library selection advice for both interactive and automated environments.
v0.6.1
- Improved error reporting for FloodWait exceptions in Telethon fetches, providing more detailed wait time messages.
- Minor code cleanups in reader and Telethon integration to simplify logic.
- Project metadata and documentation unchanged except for changelog and internal code updates.
- Patch-level release; no changes to user-facing commands or configuration.
v0.6.0
Version 0.6.0
- Added support for explicit `--config-file` and `--session-file` flags in all commands to specify custom config and session file paths.
- Documentation updated to include usage examples for new flags, especially for use in isolated agents and cron jobs.
- Internal CLI argument parsing improved to allow passing these file paths to both Pyrogram and Telethon backends.
- Minor text changes and clarifications in help and usage instructions.
- No breaking changes; all previous usages and defaults remain supported.
元数据
常见问题
Telegram Channel Reader 是什么？
Read posts and comments from Telegram channels via MTProto (Pyrogram or Telethon). Fetch recent messages and discussion replies from public or private channe... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 966 次。
如何安装 Telegram Channel Reader？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install sergei-mikhailov-tg-channel-reader」即可一键安装，无需额外配置。
Telegram Channel Reader 是免费的吗？
是的，Telegram Channel Reader 完全免费（开源免费），可自由下载、安装和使用。
Telegram Channel Reader 支持哪些平台？
Telegram Channel Reader 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Telegram Channel Reader？
由 Sergey Mikhaylov（@bzsega）开发并维护，当前版本 v0.9.2。
推荐 Skills