add-telegram

Add Telegram integration to NanoClaw for sending and receiving chat messages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

NanoClaw lacks native Telegram support, preventing teams from using Telegram groups and private chats as channels for the assistant. This Skill provides a deterministic, auditable way to add Telegram as a first-class channel so messages, typing indicators, and bot commands flow through NanoClaw like existing WhatsApp support.

Core Features & Use Cases

  • Adds a TelegramChannel implementation, unit tests, and routing changes to enable multi-channel operation.
  • Supports bot creation, environment configuration, registering group and private chats, trigger-only or main-chat behaviors, typing indicators, and media placeholders for non-text messages.
  • Use case: deploy a Telegram bot, set TELEGRAM_BOT_TOKEN, register a group as the main folder to receive assistant responses, or register trigger-only chats for command-driven interactions.

Quick Start

Run the add-telegram skill and follow the interactive prompts to provide or create a Telegram bot token, configure TELEGRAM_ONLY if needed, and register chats.

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 integration to a chatbot framework?

To add Telegram integration, run the skill and provide a Telegram bot token to enable sending and receiving messages. It merges channel configurations, adds the grammy dependency, and runs unit tests to validate routing for both group and private chats.

Can I register a Telegram group chat as the main channel to receive assistant responses?

Yes, you can register a Telegram group chat as the main folder to receive direct assistant responses. The integration supports both main chat mode for full interactions and trigger-only registrations for command-driven bot behaviors.

What is needed to configure a Telegram bot for private and group chats?

Configuring a Telegram bot requires a Telegram bot token and the TELEGRAM_BOT_TOKEN environment variable. You can also set TELEGRAM_ONLY if needed, then follow interactive prompts to complete chat registration and test validation.

Does this Telegram bot integration support typing indicators and media messages?

Yes, the Telegram bot integration supports typing indicators and media placeholders for non-text messages. It applies these features to both group and private chat scenarios, ensuring messages and bot commands flow through NanoClaw like existing WhatsApp support.

How do I validate a Telegram bot configuration after adding the channel?

You validate a Telegram bot configuration by running the included unit tests after merging channel and config changes. The skill updates environment and registration state, ensuring the Telegram bot token and chat routing work correctly before deployment.

What is the best way to handle trigger-only Telegram chat registrations?

The best way to handle trigger-only Telegram chat registrations is to configure the chat during the interactive skill prompts. This setup limits bot interactions to command-driven behaviors, distinguishing it from main chat mode where the assistant responds to all messages.