← 返回 Skills 市场
Telegram Tools Suite
作者
testman2025
· GitHub ↗
· v1.3.3
· MIT-0
211
总下载
1
收藏
0
当前安装
19
版本数
在 OpenClaw 中安装
/install telegram-tools-suite
功能描述
Telegram 自动化工具包（群监控、群搜索、批量加群、定时发送）。 运行时会生成敏感会话文件并包含可选长驻任务；默认启用风险保护，需显式确认后才可执行高风险动作。
安全使用建议
This skill appears to do what it claims, but it handles highly sensitive Telegram credentials and generates .session files (SQLite login state) and exported data (members, history, Excel reports). Before using: (1) review the omitted/truncated runtime file(s) (notably session_runtime.py) to confirm temporary session copies are not exfiltrated and are deleted as claimed; (2) run in an isolated environment (container/VM) and with a disposable/test Telegram account first; (3) keep .env and userdata/*.session private and out of any repo; (4) only enable ENABLE_HIGH_RISK_OPERATIONS / TG_ENABLE_PERSISTENT_JOIN when you understand the legal/platform risks; (5) verify network egress from the runtime environment if you need to be extra cautious (ensure only Telegram endpoints are contacted).
能力评估
Purpose & Capability
Name/description (Telegram automation: monitoring, searching, batch joining, scheduled sending) match requested env vars (TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_PHONE) and included code. Features that access members, history, and send messages are expected for this purpose.
Instruction Scope
SKILL.md instructs installing with pip, creating .env, running auth/login, and acknowledges generation of sensitive .session files and long‑running background tasks. Those instructions are appropriate but grant the skill the ability to read/write session and config files and to export members/history — use of those features can expose user data, which the README and SKILL.md correctly warn about.
Install Mechanism
No remote download/install step is defined in the skill manifest (instruction-only). The package is a local Python project with pyproject/requirements; installing via pip (local editable) is the documented method. There are no URLs or arbitrary archive extracts in the install spec.
Credentials
Required environment variables are limited to Telegram API credentials, phone number, and optional runtime toggles for high-risk features. No unrelated credentials or surprising env vars are requested.
Persistence & Privilege
Skill does not request always:true or elevated platform-wide persistence. It creates session files and may run long‑running daemons per the user’s commands; the SKILL.md documents risk-protection switches for high-risk actions.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install telegram-tools-suite - 安装完成后，直接呼叫该 Skill 的名称或使用
/telegram-tools-suite触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.3.3
安全优化：1. 为session_runtime.py临时会话复制逻辑增加明确注释，说明仅用于进程隔离防锁死，任务结束自动删除无留存；2. clawhub.yaml新增设计说明，明确告知无第三方数据传输逻辑，消除扫描误判；3. 所有安全设计完全透明可追溯
v1.3.2
元数据完全对齐：1. 补全TG_ENABLE_PERSISTENT_JOIN环境变量声明，clawhub.yaml和SKILL.md完全一致；2. 完善所有变量说明，无遗漏必填参数；3. 所有风险开关和配置要求均显式声明，解决元数据和文档不一致问题
v1.3.1
元数据更新：1. 新增clawhub.yaml配置文件，声明所有必填环境变量和风险等级；2. SKILL.md补充前置配置说明，明确列出所有环境变量要求；3. 完善高风险功能文档说明
v1.3.0
安全更新：1. 高风险功能（批量加群、定时群发）默认禁用，需显式设置ENABLE_HIGH_RISK_OPERATIONS=true环境变量才可运行；2. 增加明确的风险提示，要求用户确认使用符合Telegram服务条款；3. 修复会话文件冲突导致进程锁死的问题
v1.2.4
1. 新增定时自动群发功能，支持多群不同内容、不同间隔批量发送消息；2. 修复环境变量配置加载错误问题；3. 优化监控进程稳定性
v1.2.3
功能优化更新，完善配置与元数据对齐
v1.2.2
更新注册表元数据：补充完整所有必填/可选环境变量说明，对齐SKILL.md frontmatter与ClawHub注册表配置
v1.2.1
【安全加固整改版本】完全对齐SKILL.md/README与发布页元数据：
✅ 已完成整改项：
1. join 默认仅 --once 模式，长驻加群需显式开启 TG_ENABLE_PERSISTENT_JOIN=true
2. scheduled_send.py 需配置 TG_RISK_ACK=I_UNDERSTAND 风险确认才能启动
3. 自动操作最小间隔30分钟、单轮批量加群最多20次限流
4. 所有敏感会话文件统一存放在 userdata/ 目录，已加入全局忽略规则
📋 已明确标注：必填凭据列表、风险闸门说明、长驻任务默认关闭状态、任务停止方式，所有说明与文档一字不差对齐
v1.2.0
功能优化更新，修复元数据不一致问题，完善敏感操作提示与排除规则，移除干扰文件
v1.1.1
补充元数据声明：更新技能描述明确提示运行时会生成敏感会话文件、包含长时间运行的长驻任务，完善安全提示与安装前须知，对齐SKILL.md文档与注册表元数据
v1.1.0
完成规则&关键词配置化改造：所有监控规则、搜索关键词均已迁移到配置文件，无硬编码内容，支持用户自定义修改无需改动业务代码
v0.2.1
🔒 安全修复：彻底移除所有误提交的敏感文件，补充.gitignore规则防止后续误提交，无任何个人信息泄露风险
v0.2.0
🔥 新增多群多内容定时发送功能：支持同时配置任意数量定时任务，每个任务可独立设置目标群、发送内容、发送间隔，所有任务并行运行互不干扰，完全兼容旧版单任务配置，更新使用说明文档
v0.1.6
彻底删除重复的Post-Install Interaction Flow和First Run Checklist内容，仅保留统一的首次运行引导流程，无任何冗余信息
v0.1.5
精简SKILL.md内容，删除重复的安全提示和前置说明，内容更简洁无冗余
v0.1.4
完善安装后引导说明，更新标准化首次运行流程，步骤更清晰无歧义
v0.1.2
修复滥用风险：移除所有硬编码的发送目标/消息内容/规则，新增滥用警告，所有配置完全由用户自行填写，无预定义垃圾内容
v0.1.1
修复元数据误导问题：补充必填环境变量声明，新增敏感文件安全提示
v1.0.0
Telegram Tools Suite 1.0.0 – Initial Release
- Provides an automation toolkit for Telegram including group monitoring, scheduled messaging, auto group joining, group search, member export, and more.
- Detailed post-installation flow and first run checklist to streamline setup, with support for Telegram API authentication and login.
- Includes runtime config files for customizing monitored groups, keywords, group search parameters, and batch join targets.
- Offers a command-line interface covering group listing, account info, member export, message history export, monitoring, group search, and batch group joining.
- Enforces strict security rules against sensitive data leakage and ensures long-running tasks are non-conflicting per Telegram session.
元数据
常见问题
Telegram Tools Suite 是什么？
Telegram 自动化工具包（群监控、群搜索、批量加群、定时发送）。 运行时会生成敏感会话文件并包含可选长驻任务；默认启用风险保护，需显式确认后才可执行高风险动作。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 211 次。
如何安装 Telegram Tools Suite？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install telegram-tools-suite」即可一键安装，无需额外配置。
Telegram Tools Suite 是免费的吗？
是的，Telegram Tools Suite 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Telegram Tools Suite 支持哪些平台？
Telegram Tools Suite 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Telegram Tools Suite？
由 testman2025（@testman2025）开发并维护，当前版本 v1.3.3。
推荐 Skills