Telegram Login Helper — Telegram 登录助手
v1.0.0整合和自动化Telegram个人账户登录工作流程，包括命名空间复用、QR码登录、批量登录、会话复制和人机验证等，适用于TDLib。
0· 30·0 当前·0 累计
by @stevewu422运行时依赖
无特殊依赖
安装命令
点击复制官方npx clawhub@latest install telegram-login-helper
镜像加速npx clawhub@latest install telegram-login-helper --registry https://cn.longxiaskill.com 镜像可用
技能文档
Telegram Login Helper 这个 skill 专门处理 Telegram 个人账号登录，不是 bot token。
适用场景：
- tdl / TDLib 登录卡住
- QR 扫码登录做不完
- 需要复用已有 namespace
- 需要一次性登录多个人号 namespace
- 另一个 agent 需要一份清晰的本地登录 runbook
核心路线： 永远优先走 personal account 路线：tdl TDLib MTProto，不要因为 QR 登录不顺就切去 Bot API。
已确认的本地现实：
- 已有可复用 namespace：steve
- TDLib 数据目录：/home/stevewu/.tdl/data
- 单 namespace 复用脚本：/home/stevewu/.openclaw/workspace/skills/telegram-login-helper/scripts/reuse_namespace.sh
- 多 namespace QR 登录脚本：/home/stevewu/.openclaw/workspace/skills/telegram-login-helper/scripts/login_10_namespaces.sh
- 参考 runbook：/home/stevewu/.openclaw/workspace/skills/telegram-login-helper/references/runbook.md
推荐处理顺序：
- 先复用已有 namespace，先别急着重新登录，先测旧登录态还活不活：
- 需要新 namespace 时，走 QR 登录：
- 如果 QR 不可用，复制已有 TDLib state：
- 再不行，走 MTProto / code login：
- 最后才升级为人工一次性登录：
登录后怎么验活：
- 先测 namespace：tdl chat ls -n steve --limit 10
- 再测 personal reader/export 路线：
不要做的事：
- 不要把 personal-account 登录问题误切到 bot tooling
- 不要明明缺 TELEGRAM_API_ID / TELEGRAM_API_HASH 还假装 MTProto 已可用
- 不要在已有 namespace 可用时重复登录
- 不要让另一个 agent 因为扫不了二维码就误判“Telegram 读不了”
相关技能：
- telegram-personal-ops：登录成功后做聊天读取与导出
- telegram-multi-account-monitor：多个 personal account 登录完成后做只读监控
- telegram-reader-login-helper：更偏向“QR 登录失败时如何救火”的窄场景版
一句话总结： Telegram 登录问题的正确解法是：先复用，再转移 session，再补 fallback，最后才麻烦人类。