telegram-doctor

Diagnose Telegram configuration and connectivity issues using Python and the Telegram API.

5|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/lycfyi/community-agent-plugin --skill telegram-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telegram-doctor
Source: https://github.com/lycfyi/community-agent-plugin/tree/main/plugins/telegram-connector/skills/telegram-doctor
Command: npx skills add https://github.com/lycfyi/community-agent-plugin --skill telegram-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill diagnoses Telegram configuration and connectivity issues for the Telegram integration, helping users identify misconfigurations, authentication problems, or connection errors.

Core Features & Use Cases

  • Environment checks: Verifies required environment variables and config files.
  • Connectivity verification: Validates Telegram API connection and session validity.
  • Guided remediation: Provides actionable steps to fix common Telegram setup problems.

Quick Start

Run the Telegram Doctor to scan your Telegram integration: python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_doctor.py

Frequently Asked Questions about telegram-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose Telegram sync issues and authentication errors?

To diagnose Telegram sync issues, run the Telegram Doctor script to verify environment variables, validate Telegram API connectivity, and check session validity. It scans your configuration and presents actionable remediation steps for any detected setup problems.

Why does my Telegram integration not work after setup?

Your Telegram integration may not work due to misconfigurations, missing environment variables, or invalid API sessions. The diagnostic tool checks your local agent config file and Telegram API connection to identify the exact failure point and provide guided fixes.

What do I need to run Telegram connectivity diagnostics?

You need Python installed, access to the Telegram API, and a local agent config file located at config/agents.yaml. These prerequisites allow the diagnostic script to scan your environment and verify Telegram session validity.

Can I verify my Telegram API session validity without manually testing endpoints?

Yes, you can verify Telegram API session validity automatically by running the diagnostic tool. It performs environment checks and connectivity verification against the Telegram API to confirm your session is active and properly authenticated.

How to fix Telegram configuration misconfigurations across integrations?

To fix Telegram configuration misconfigurations, execute the diagnostic script to scan your integration setup. It identifies missing environment variables and config errors, then provides specific remediation steps to correct the authentication and connection problems.