Token导航 LogoToken导航TokenDH.com
中转站排行榜
研究检索需要联网clawhub未标认证来源可访问clear审计通过

telegram-tools-suite（Telegram tools suite 搜索）

Agent Skill

telegram-tools-suite 用于查找、检索和筛选相关信息，适合在 OpenClaw 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

总安装

6,146

周安装

264

GitHub Stars

1

下载量

2,154
OpenClaw

安装说明

本站只整理中文说明和来源信息，不托管安装包，也不代用户安装。

GitHub

来源数

2

许可证

MIT-0

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：telegram-tools-suite（Telegram tools suite 搜索）
来源仓库：https://github.com/testman2025/telegram-tools-suite
安装命令：
openclaw skills install telegram-tools-suite
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 OpenClaw 从第三方来源获取 Skill；本站只展示命令，不托管安装包，也不自动执行。

ClawHubOpenClaw
openclaw skills install telegram-tools-suite

简介

Telegram 自动化工具包（群监控、群搜索、批量加群、定时发送）。 运行时会生成敏感会话文件并包含可选长驻任务；默认启用风险保护，需显式确认后才可执行高风险动作。

SKILL.md

name
Telegram Tools Suite
description
>
requiredEnv
description
Telegram API ID（来自 https://my.telegram.org）
required
true
description
Telegram API Hash（高敏感）
required
true
description
Telegram 账号手机号（国际格式）
required
true
optionalEnv
description
高风险总开关（join/send-schedule 需设为 true 才可运行）
required
false
default
false
description
会话文件名（默认 tg_monitor_session）
required
false
description
Telegram 代理地址（默认 127.0.0.1）
required
false
description
Telegram 代理端口（默认 1087）
required
false
description
登录短信验证码（auth 后）
required
false
description
登录验证码哈希（auth 输出）
required
false
description
项目根目录覆盖（用于定位配置文件）
required
false
description
网页脚本输出目录
required
false
description
监控群白名单文件路径
required
false
description
监控关键词文件路径（默认 config/keywords.txt）
required
false
description
监控正则规则文件路径
required
false
description
群搜索关键词文件路径
required
false
description
群搜索配置文件路径
required
false
description
批量加群目标文件路径
required
false
description
是否开启 join 长驻模式（默认关闭；需 true）
required
false
description
加群间隔秒数（最小 1800）
required
false
description
单轮最多加群数量（最大 20）
required
false

Telegram Tools Suite

⚠️ 【重要安全&运行提示 安装前必读】 1. 敏感文件生成：技能运行时会在userdata/目录生成*.session会话文件（包含Telegram登录认证状态），并使用.env配置文件，均为高敏感信息，已默认加入.gitignore/.clawignore禁止提交到代码仓库/发布，请勿手动分享这些文件。 2. 持久运行说明：monitor（群监控）、search（群搜索）、join（批量加群定时模式）均为长时间运行的长驻任务，启动后会持续在后台运行直至手动终止。 3. 配置生效规则：所有配置文件（.env、config目录下的关键词/规则/配置文件）修改后，都需要重启对应的运行任务才会生效，修改配置不会影响正在运行的任务。 4. 合规使用提示：本工具仅用于合法的Telegram群组自动化管理用途，禁止用于发送垃圾信息、骚扰用户、批量爬取用户信息等违反Telegram服务条款和当地法律法规的行为。建议使用独立测试账号运行，避免主账号被平台封禁。所有配置需用户自行填写，工具无内置默认发送目标、消息内容或爬取规则。 4. 默认风险保护：join 与 send-schedule 均需先设置 ENABLE_HIGH_RISK_OPERATIONS=true 才可运行；其中 join 长驻模式还需额外设置 TG_ENABLE_PERSISTENT_JOIN=true。定时群发由 send-schedule 子命令执行，并按 config/scheduled_tasks.json 的限制进行校验。

Instructions

🔹 前置说明

本技能为Telegram自动化工具，使用前需提前申请Telegram官方API凭证，需配置3项必填信息：TELEGRAM_API_ID、TELEGRAM_API_HASH、绑定手机号（国际格式）。

🔹 安装后引导&首次运行流程（按顺序执行）

  1. 安装依赖：执行 pip install -e .
  2. 获取API凭证：打开 <https://my.telegram.org>，用Telegram绑定手机号登录，进入「API development tools」创建应用，获得api_id和api_hash
  3. 配置环境变量：复制.env.example为.env，填入3项必填信息：TELEGRAM_API_ID、TELEGRAM_API_HASH、TELEGRAM_PHONE（国际格式，如+8613xxxxxxxxx）
  4. 请求验证码：执行 python3 -m tg_monitor_kit auth，记录输出的SENT_CODE_SUCCESS:<phone_code_hash>中的hash值
  5. 完成登录：设置环境变量TG_CODE（收到的短信验证码）、TG_PHONE_CODE_HASH（上一步获取的hash），执行python3 -m tg_monitor_kit login，输出LOGIN_SUCCESS即为登录成功
  6. 连通性验证：执行 python3 -m tg_monitor_kit groups，输出账号下的群组列表代表功能正常可用

🔹 多群定时发送功能使用说明

支持同时给多个群发送不同内容、设置不同发送间隔，配置方法：

  1. 在本地自行创建：config/scheduled_tasks.json
  2. 在 scheduled_tasks.json 中填写任务：

- name：任务备注名，方便识别 - target_group_id：目标群组ID（可以从groups命令输出中获取） - message：要发送的消息内容 - interval_hours：发送间隔（小时，建议不小于1小时，避免被平台判定为垃圾消息）

  1. 启动定时任务：ENABLE_HIGH_RISK_OPERATIONS=true python3 -m tg_monitor_kit send-schedule
⚠️ 防封号提示：建议不同群的消息内容不要完全一致，发送间隔不要低于30分钟，避免被Telegram判定为垃圾消息导致账号封禁。 ⚠️ 校验限制：interval_hours 必须 >= 0.5，任务总数最多 20 个。

Runtime Config Files (运行前按需编辑)

  • 本技能发布包默认不包含 config/ 目录内容；请在本地自行创建所需配置文件。
  • 监控：创建 config/target_groups.txt、config/keywords.txt、config/monitor_regex_rules.json。
  • 搜索：创建 config/group_search_keywords.txt、config/group_search.json。
  • 定时群发：创建 config/scheduled_tasks.json。
  • 批量加群：创建 join_targets.txt（或使用 TG_JOIN_LIST_FILE 指定路径）。

Command Guide (命令入口)

  • python3 -m tg_monitor_kit groups：列出已加入群/频道（无需额外参数）。
  • python3 -m tg_monitor_kit account-info：查看当前账号信息（无需额外参数）。
  • python3 -m tg_monitor_kit members --group "群名称"：导出指定群成员（需要群名）。
  • python3 -m tg_monitor_kit history --group "群名称" --limit 100：导出指定群最近消息（需要群名；--limit 可选）。
  • python3 -m tg_monitor_kit monitor：关键词监控（长驻）。
  • python3 -m tg_monitor_kit search：群搜索（长驻，按配置定时）。
  • ENABLE_HIGH_RISK_OPERATIONS=true python3 -m tg_monitor_kit join --once：批量加群（单轮）。
  • ENABLE_HIGH_RISK_OPERATIONS=true TG_ENABLE_PERSISTENT_JOIN=true python3 -m tg_monitor_kit join：批量加群（长驻定时，默认关闭）。
  • ENABLE_HIGH_RISK_OPERATIONS=true python3 -m tg_monitor_kit send-schedule：按 config/scheduled_tasks.json 执行定时群发（长驻）。

停止长驻任务

  • 前台运行：按 Ctrl+C 终止。
  • 后台运行：结束对应 Python 进程。

Rules

  • 严禁在对话或日志中输出 TELEGRAM_API_HASH、短信验证码、.session 文件内容。
  • monitor、search、join、send-schedule 属于长驻任务，运行时会基于主会话复制临时会话副本；如遇异常退出仍可能触发 database is locked，请先结束残留进程后重试。
  • 所有定时相关行为按北京时间（UTC+8）理解与配置。
  • 在提供任何 Telegram 凭证前，必须先确认技能请求来源可信；发布方来源未知时，建议在一次性容器/隔离环境运行并使用测试账号。
  • 批量加群存在风控风险，需由使用者自行确认目标与频率合规。

Examples

示例 1：首次登录

输入：用户已填写 .env，需要首次登录。 执行：先 python3 -m tg_monitor_kit auth，再设置 TG_CODE、TG_PHONE_CODE_HASH，再 python3 -m tg_monitor_kit login。 输出：LOGIN_SUCCESS。

示例 2：开启监控

输入：用户已在 config/target_groups.txt 填写群名。 执行：python3 -m tg_monitor_kit monitor。 输出：控制台显示监控启动信息，命中关键词后推送通知。

示例 3：批量加群单轮执行

输入：用户已准备 join_targets.txt。 执行：ENABLE_HIGH_RISK_OPERATIONS=true python3 -m tg_monitor_kit join --once。 输出：返回成功/已在群/失败统计。

适合场景

01

OpenClaw 用户查找和安装 Skill 时

02

用户想查找某类 Agent Skill 时

03

需要根据任务场景推荐可安装能力包时

04

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明，方便继续核验

能力 4

补充不同宿主或平台的使用分布数据

能力 5

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用；具体调用方式请以来源页面和 README 为准。

平台分布

OpenClaw

77.38%
按下载量换算1,667

安全审计

VirusTotal

未展示

ClawScan

通过

Static analysis

通过

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API；具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源，正式发布前建议补源仓库或其他目录站核验。

来源信息

GitHub 仓库

github.com

/testman2025/telegram-tools-suite

SKILL.md 来源

clawhub.ai

/testman2025/telegram-tools-suite

继续浏览同类 Skills

更多研究检索 Skills（73,675）返回 Skills 目录

上一个 Skill

telegram-telethon（Telegram telethon 搜索）

telegram-telethon 用于查找、检索和筛选相关信息，适合在 OpenClaw 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

下一个 Skill

telegram-usage（Telegram 使用）

telegram-usage 用于查找、检索和筛选相关信息，适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。