telegram-userbots
本技能介绍 Telegram userbot(用户机器人)的适用场景与风险,核心是区分 bot token 与 MTProto 用户会话的差异:bot token 是发给软件的凭证,而 MTProto 会话代表一个已登录的真实人账号,拥有该人的同等权限,且缺乏 token 的保护机制。技能基于 Telethon 1.44.0 与 core.telegram.org 的资料整理(截至 2026-08-25),给出是否需要 userbot 的判断表,涵盖需读取非管理频道历史、读取加入前的聊天记录、以特定人身份操作、下载超过 20MB 文件、批量枚举群成员等场景。同时强调会话文件即凭证,必须存入密钥库、加入 .gitignore 并可撤销;FloodWaitError 是 API 正常工作的一部分,应设置上限、告警而非无界等待;应固定 Telethon 次版本号;实体解析可能触发网络请求并导致 FloodWait;用户账号存在被限制或封禁的风险,且账号被撤销的会话是终态故障,需告警并停止而非无限重启。