Telegram Tools Suite

⚠️ 【重要安全&运行提示安装前必读】

敏感文件生成：技能运行时会在userdata/目录生成*.session会话文件（包含Telegram登录认证状态），并使用.env配置文件，均为高敏感信息，已默认加入.gitignore/.clawignore禁止提交到代码仓库/发布，请勿手动分享这些文件。

持久运行说明：monitor（群监控）、search（群搜索）、join（批量加群定时模式）均为长时间运行的长驻任务，启动后会持续在后台运行直至手动终止。

合规使用提示：本工具仅用于合法的Telegram群组自动化管理用途，禁止用于发送垃圾信息、骚扰用户、批量爬取用户信息等违反Telegram服务条款和当地法律法规的行为。建议使用独立测试账号运行，避免主账号被平台封禁。所有配置需用户自行填写，工具无内置默认发送目标、消息内容或爬取规则。

默认风险保护：join 默认仅允许 --once；若需长驻必须设置 TG_ENABLE_PERSISTENT_JOIN=true。scheduled_send.py 默认拒绝发送，需设置 TG_RISK_ACK=I_UNDERSTAND 后才执行。

Instructions

🔹 前置说明

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