Agent-Skills.md

Agent Skills: Infra Telegram Session

Create/update Telethon session

UncategorizedID: aaaaqwq/claude-code-skills/telegram-session

Repository

aaaaqwq/claude-code-skills
aAAaqwqLicense: MIT
7317

Install this agent skill to your local

pnpm dlx add-skill https://github.com/aAAaqwq/AGI-Super-Team/tree/HEAD/skills/telegram-session

Skill Files

Browse the full folder contents for telegram-session.

Download Skill

Loading file tree…

skills/telegram-session/SKILL.md

Skill Metadata

Name
telegram-session
Description
Create/update Telethon session

Infra Telegram Session

Managing Telegram session via tg-auth

When to use

  • "telegram is not working"
  • "SessionExpiredError" / "AuthKeyUnregisteredError"
  • "check telegram session"
  • First launch on a new device

Tool

$TG_TOOLS_PATH/tools/tg_auth.py

How to execute

Check session

python3 $TG_TOOLS_PATH/tools/tg_auth.py check

Shows: name, username, phone + last 10 chats.

QR Login (new session)

# QR + wait for scan (2 min timeout)
python3 $TG_TOOLS_PATH/tools/tg_auth.py qr

# Only show QR (without waiting)
python3 $TG_TOOLS_PATH/tools/tg_auth.py qr --no-wait

On phone: Settings > Devices > Link Desktop Device > scan QR.

List sessions

python3 $TG_TOOLS_PATH/tools/tg_auth.py sessions

Shows all .session files in the sessions directory.

Custom session

python3 $TG_TOOLS_PATH/tools/tg_auth.py --session /path/to/session check

Paths

| What | Path | |------|------| | Default session | $SALES_PATH/telegram/sessions/telegram_session.session | | ENV | $SALES_PATH/.env |

Troubleshooting

| Problem | Solution | |---------|----------| | SessionExpiredError | tg-auth qr -- create a new session | | AuthKeyUnregisteredError | tg-auth qr -- re-login | | "Not authorized" | tg-auth qr | | FloodWaitError | Wait the specified time | | QR timeout | Run tg-auth qr again |

Related skills

  • telegram-send -- sending messages
  • telegram-check -- checking replies