add-telegram

Add Telegram channel support to NanoClaw using the grammy library.

Updated Feb 24, 2026
One-click install
npx skills add https://github.com/webboty/flexclaw --skill add-telegram-webboty
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-telegram
Source: https://github.com/webboty/flexclaw/tree/main/.claude/skills/add-telegram
Command: npx skills add https://github.com/webboty/flexclaw --skill add-telegram-webboty

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill integrates Telegram as a first-class channel for NanoClaw so agents can communicate with users in Telegram groups and private chats without manual code edits or fragile ad-hoc routing.

Core Features & Use Cases

  • Deterministic code package that adds a Telegram Channel implementation, routing updates, configuration keys, and unit tests so the change can be applied and reverted reliably.
  • Handles mention-to-trigger translation, group vs private naming, media placeholders (photo, video, voice, document, sticker, location, contact), and typing indicators.
  • Provides interactive setup guidance for creating a bot token, syncing environment variables to container runtime, registering chats (tg:<id>), and optional Agent Swarm support.
  • Includes manifest and intent files to support three-way merges, automated tests, and a removal procedure for clean uninstallation.

Quick Start

Add Telegram channel to NanoClaw and walk me through creating a bot token, updating TELEGRAM_BOT_TOKEN and TELEGRAM_ONLY, and registering a chat so the bot can respond in Telegram.

Frequently Asked Questions about add-telegram

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

FAQPage Schema
How do I add Telegram channel support to a chatbot agent?

You can add Telegram channel support by integrating the grammy library to handle routing and configuration keys like TELEGRAM_BOT_TOKEN, enabling agents to send and receive messages in private chats and groups.

How does mention-to-trigger translation work for Telegram group chats?

Mention-to-trigger translation maps bot mentions in Telegram group chats to agent triggers, allowing the bot to distinguish between group and private naming conventions and respond appropriately to targeted messages.

Can I handle media messages like photos and voice notes in a Telegram bot integration?

Yes, the Telegram channel integration provides media placeholders for photos, videos, voice notes, documents, stickers, locations, and contacts, allowing agents to process and acknowledge various media types.

What do I need to set up to deploy a multi-channel agent with Telegram?

Multi-channel agent deployment requires creating a Telegram bot token, syncing environment variables to container runtime, and registering chats using the tg:<id> format to enable bot responses.

Does the Telegram channel integration support clean uninstallation and testing?

Yes, the integration includes manifest and intent files for deterministic three-way merges, unit tests for validation, and a removal procedure to ensure clean and reliable uninstallation of the Telegram channel.

Are typing indicators supported in Telegram agent messaging?

Yes, typing indicators are supported in the Telegram channel implementation, providing real-time feedback to users when the agent is processing a message and preparing a response.