instar-telegram

Connect an agent to Telegram for two-way messaging and proactive notifications.

75|18|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/JKHeadley/instar --skill instar-telegram
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: instar-telegram
Source: https://github.com/JKHeadley/instar/tree/main/skills/instar-telegram
Command: npx skills add https://github.com/JKHeadley/instar --skill instar-telegram

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of keeping an agent reachable by turning Telegram into a persistent two-way channel for alerts, replies, and session handoff.

Core Features & Use Cases

  • Two-way agent messaging: Send instructions to an agent from your phone and receive responses without staying at your terminal.
  • Topic-based conversations: Map Telegram forum topics to Claude sessions so each thread stays organized and stateful.
  • Proactive notifications: Alert users about job completions, health checks, blockers, and other events that need attention.
  • Use Case: A scheduled task finishes overnight, posts its summary to a Telegram topic, and lets the user reply with follow-up instructions from anywhere.

Quick Start

Use Instar to connect your agent to Telegram, then configure your bot token and chat ID so messages can flow between your Claude session and your Telegram group.

Frequently Asked Questions about instar-telegram

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

FAQPage Schema
How do I send messages to my agent from Telegram?

Telegram two-way agent messaging maps a chat to a Claude session, enabling you to send instructions and receive responses remotely without staying at your terminal.

Can I map Telegram topic threads to individual Claude sessions?

Yes, mapping Telegram forum topics to Claude sessions keeps each topic thread organized and stateful, ensuring conversations mapped to sessions remain distinct and persistent.

What is the best way to get proactive notifications for agent job completions?

Proactive notifications for job completions are sent directly to Telegram, alerting you about job statuses, health checks, and blockers that need immediate attention from anywhere.

Do I need an Instar server to connect Claude to Telegram?

Yes, an installed Instar server configured with Telegram bot credentials, topic-session mapping, and message relay support is required to connect your agent and send or receive replies.

How does two-way agent communication work with scheduled tasks?

Two-way agent communication lets scheduled tasks post summaries to Telegram topics when finished, allowing you to reply with follow-up instructions from anywhere without terminal access.