telegram-telethon

Automate Telegram messaging and trigger Claude Code sessions from chat events.

6|2|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/dandaka/skills --skill telegram-telethon-dandaka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telegram-telethon
Source: https://github.com/dandaka/skills/tree/main/telegram-telethon
Command: npx skills add https://github.com/dandaka/skills --skill telegram-telethon-dandaka

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires telethon, rich, questionary, qrcode, and includes scripts (resource) components.

What problem does it solve?

Enables reliable, automated Telegram interactions and background monitoring so you can respond, transcribe, and run Claude Code sessions per chat without manual supervision or repetitive CLI steps.

Core Features & Use Cases

  • Daemon-mode monitoring: run a background daemon that watches chats, applies regex triggers, and spawns or resumes per-chat Claude Code sessions.
  • Full Telethon CLI: list chats, fetch recent messages, search, download media, manage drafts, send/edit/delete/forward messages, and mark read.
  • Claude integration & queuing: capture matched text, call the claude CLI with configurable allowed tools and timeouts, persist session IDs in sessions.json, and queue requests to avoid rate limits.
  • Media & transcription: download attachments, transcribe voice messages with Telegram Premium, Groq, or local Whisper fallbacks.
  • Safety & controls: whitelist groups for sending, explicit draft vs send semantics, and session persistence to recover across restarts.

Quick Start

Run the setup wizard to provide API credentials, configure daemon triggers, then start the daemon to monitor chats and spawn Claude sessions.

Frequently Asked Questions about telegram-telethon

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

FAQPage Schema
How do I automate Telegram message monitoring to trigger Claude sessions?

You can automate Telegram monitoring by running a background daemon that watches incoming chat events, applies regex triggers, and spawns per-chat Claude Code sessions. The daemon persists session IDs in a JSON file to resume conversations and queues requests to avoid hitting rate limits.

Can I transcribe Telegram voice messages using Whisper or Groq?

You can transcribe Telegram voice messages using Groq or local Whisper as fallback backends, alongside Telegram Premium transcription. The daemon downloads voice note attachments and routes them through the configured transcription backend to generate text from the audio.

What do I need to set up a Telethon-based Telegram automation daemon?

Setting up the Telethon-based daemon requires configured Telegram API credentials and a Claude CLI accessible in your system PATH. Optional Groq or Whisper backends can be configured for voice note transcription, all initialized through a setup wizard.

How do I manage Telegram drafts and send messages safely via a CLI?

You manage Telegram drafts and send messages safely via a CLI that enforces explicit draft versus send semantics and group whitelists for outbound messages. The CLI supports listing chats, fetching messages, editing, forwarding, and marking messages as read.

Does this Telegram automation tool support downloading media and attachments?

Yes, the tool supports downloading media and attachments from Telegram chats. It uses Telethon to fetch and download media files from specified chats, enabling automated archival of attachments alongside message monitoring and Claude session orchestration.

Why does my Claude Code session lose context when monitoring Telegram chats?

Claude Code sessions lose context across daemon restarts if session IDs are not persisted. The daemon stores session IDs in a sessions.json file to recover and resume per-chat Claude Code sessions, ensuring conversation continuity and preventing context loss.