telegram-init
Initialize Telegram configuration. Use when user wants to set up, configure, or connect their Telegram account for the first time.
When & Why to Use This Skill
The telegram-init Claude skill streamlines the initial setup and configuration of Telegram account integrations. It automates the complex process of credential validation, session authentication, and group discovery, providing a secure and verified foundation for advanced Telegram-based AI workflows, message archiving, and automated communication management.
Use Cases
- Secure Account Authentication: Quickly connect your Telegram account to Claude by validating API credentials and session strings to ensure a stable and authorized connection.
- Automated Environment Setup: Automatically update configuration files and environment variables, reducing manual errors when preparing your system for Telegram message synchronization.
- Group and Channel Mapping: Effortlessly discover and list all accessible Telegram groups and channels, allowing you to set default targets for monitoring, data extraction, or automated reporting tasks.
| name | telegram-init |
|---|---|
| description | "Initialize Telegram configuration. Use when user wants to set up, configure, or connect their Telegram account for the first time." |
telegram-init
Initialize Telegram connection and configure sync settings.
Trigger Phrases
- "set up Telegram"
- "configure Telegram"
- "initialize Telegram"
- "connect Telegram"
- "telegram init"
Description
This skill initializes your Telegram connection by:
- Validating your Telegram API credentials
- Testing the session string authentication
- Listing all accessible groups and channels
- Optionally setting a default group for other commands
Prerequisites
Before using this skill, you must:
Get API credentials from https://my.telegram.org/apps
- Log in with your phone number
- Create an application
- Note your
API_IDandAPI_HASH
Generate a session string using:
python ${CLAUDE_PLUGIN_ROOT}/scripts/generate_session.pyThis will prompt for your phone number and verification code.
Add credentials to .env:
TELEGRAM_API_ID=your_api_id TELEGRAM_API_HASH=your_api_hash TELEGRAM_SESSION=your_session_string
Usage
Basic initialization:
python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_init.py
Set a specific group as default:
python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_init.py --group 1234567890
Output
- Lists all accessible groups with ID, type, and member count
- Updates
config/agents.yamlwith Telegram settings - Displays next steps for syncing messages
Warning
Using a user token may violate Telegram's Terms of Service. This tool is intended for personal use only:
- Archiving your own conversations
- Analyzing communities you actively participate in
Use at your own risk.
Exit Codes
0- Success1- Authentication error (invalid/expired session)2- Configuration error (missing credentials)
Related Skills
telegram-list- List groups and topicstelegram-sync- Sync messages to local storagetelegram-read- Read synced messages