Telegram Doctor

When to Use

• User says "Telegram not working" or "diagnose Telegram"
• User reports connection or authentication errors
• User says "check Telegram setup" or "troubleshoot Telegram"
• Before asking for help with Telegram issues
• When sync or other Telegram commands fail unexpectedly

How to Execute

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_doctor.py

What It Checks

1. Environment file -

   .env

   exists in cwd
2. API ID -

   TELEGRAM_API_ID

   is set and numeric
3. API hash -

   TELEGRAM_API_HASH

   is set
4. Session string -

   TELEGRAM_SESSION

   is set and valid length
5. Authentication - Credentials can connect to Telegram API
6. Config file -

   config/agents.yaml

   exists and is valid YAML
7. Group configured - A default group is selected
8. Data directory -

   data/

   is writable

Output

• ✓ for passed checks
• ✗ for failed checks

Example Output

telegram-doctor results:

  ✓ Environment file (.env found)
  ✓ API ID (12345678)
  ✓ API hash (abc123...xyz9)
  ✗ Session string (Session appears too short)
  ✗ Config file (config/agents.yaml not found)
  ✗ Group configured (No default group set)
  ✓ Data directory (./data)

Some checks failed. Suggested fixes:

  • Session string:
    Generate a fresh session: python scripts/generate_session.py

  • Config file:
    Run telegram-init to create the config file

  • Group configured:
    Run telegram-init to select a group

(Run these steps manually - doctor does not modify files)

Next Steps

1. Run

   telegram-init

   to reconfigure if needed
2. Run

   telegram-sync

   to test connectivity