Best use case
telegram-session is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Create/update Telethon session
Teams using telegram-session should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/telegram-session/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How telegram-session Compares
| Feature / Agent | telegram-session | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Create/update Telethon session
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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 ```bash python3 $TG_TOOLS_PATH/tools/tg_auth.py check ``` Shows: name, username, phone + last 10 chats. ### QR Login (new session) ```bash # 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 ```bash python3 $TG_TOOLS_PATH/tools/tg_auth.py sessions ``` Shows all `.session` files in the sessions directory. ### Custom session ```bash 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
Related Skills
telegram-send
Telegram DM sending from CSV, rate limiting, idempotency
telegram-scraper-run
Automatic Telegram scraping
telegram-scrape
Search Telegram channels, read posts, ad contacts
telegram-push
通过独立 Telegram Bot 向群聊或私聊推送消息，适合不依赖 OpenClaw channel 配置的通知场景。
telegram-inbound-run
Automatic inbound Telegram message processing
telegram-groups
Posting, members, Telegram group management
telegram-contacts
Export/import/lookup Telegram contacts
telegram-check
Check inbound Telegram messages
telegram-automation
Automate Telegram tasks via Rube MCP (Composio): send messages, manage chats, share photos/documents, and handle bot commands. Always search tools first for current schemas.
session-logs
Search and analyze your own session logs (older/parent conversations) using jq.
wemp-operator
> 微信公众号全功能运营——草稿/发布/评论/用户/素材/群发/统计/菜单/二维码 API 封装
zsxq-smart-publish
Publish and manage content on 知识星球 (zsxq.com). Supports talk posts, Q&A, long articles, file sharing, digest/bookmark, homework tasks, and tag management. Use when publishing content to 知识星球, creating/editing posts, uploading files/images/audio, managing digests, batch publishing, or formatting content for 知识星球.