telegram-init_skill

Overview

This skill initializes and configures a Telegram connection so your agent can access and sync Telegram groups and channels. It validates API credentials and session authentication, lists accessible chats, and can set a default target group for subsequent operations. Use it as the first step before syncing or reading Telegram messages.

How this skill works

The tool verifies TELEGRAM_API_ID, TELEGRAM_API_HASH, and a generated session string, then attempts an authenticated session with Telegram. It enumerates all accessible groups and channels, returns IDs, types, and member counts, and writes Telegram settings into the agent configuration file. Optionally it sets a default group ID so other commands know which group to operate on.

When to use it

• Setting up Telegram access for the first time
• Revalidating credentials after login changes or session expiry
• Choosing a default group for message sync or reads
• Preparing the agent to sync or analyze Telegram conversations
• Troubleshooting authentication or configuration errors

Best practices

• Generate the session string on a trusted machine and never share it publicly
• Store API_ID, API_HASH, and SESSION in environment variables or a secure .env file
• Run the init tool interactively to confirm the correct group or channel before saving defaults
• Use a personal account only for archiving or analyzing conversations you participate in
• Check exit codes and logs when the tool reports authentication or configuration issues

Example use cases

• Initial setup: validate credentials and create Telegram entries in agents configuration
• Switch default group: point subsequent sync commands at a specific Telegram group
• Audit access: list all groups and channels the current session can reach and confirm member counts
• Recover from auth errors: regenerate session, run init, and confirm status before syncing
• Onboard a new machine: generate session string, add credentials to .env, and run init to reconfigure access