add-telegram

Integrate Telegram channel support into NanoClaw with registration flows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates adding Telegram as a messaging channel to a NanoClaw deployment, removing the manual, error-prone steps of wiring bot code, environment variables, service registration, and chat onboarding. It provides deterministic code changes, testable channel logic, and interactive setup so Telegram chats can be registered and used reliably by agents.

Core Features & Use Cases

  • Adds a TelegramChannel implementation and unit tests, updates the channel barrel import, and records state so the codebase recognizes Telegram as a first-class channel.
  • Guides users through creating or providing a Telegram bot token, syncing credentials into the container environment, adjusting group privacy, registering chats, and verifying message flow.
  • Use case: enable a team Telegram group to receive notifications and interact with NanoClaw agents or run an Agent Swarm where subagents appear as distinct Telegram identities.

Quick Start

Use the add-telegram skill to install the Telegram channel, provide or create a bot token, sync TELEGRAM_BOT_TOKEN into the container environment, and register your chat.

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 NanoClaw deployment?

To add Telegram channel support to NanoClaw, you add the channel source files, append the import to the channel barrel, set the TELEGRAM_BOT_TOKEN environment variable, and install the grammy dependency. This enables group and private chat connectivity for your agents.

Do I need a bot token to integrate Telegram messaging with NanoClaw?

Yes, you need a TELEGRAM_BOT_TOKEN in the container environment to integrate Telegram messaging with NanoClaw. The setup guides you through creating or providing a bot token and syncing credentials so agents can reliably handle messages.

How does NanoClaw handle Telegram chat discovery and message handling?

NanoClaw handles Telegram chat discovery and message handling by implementing registration workflows for chats and processing text and media placeholders. The TelegramChannel implementation manages connectivity so agents can interact in both group and private chats.

What is the best way to register Telegram chats with an agent swarm?

The best way to register Telegram chats with an agent swarm is using interactive setup flows that adjust group privacy and verify message flow. This allows subagents to appear as distinct Telegram identities and reliably receive notifications.

Why do I need the grammy dependency for a Telegram chatbot channel?

You need the grammy dependency for a Telegram chatbot channel because it provides the underlying framework for the TelegramChannel implementation. Adding it ensures the channel logic passes unit tests and the build recognizes Telegram as a first-class channel.

Can I run unit tests after wiring Telegram bot code into NanoClaw?

Yes, you can and should run unit tests after wiring Telegram bot code into NanoClaw. The process includes adding deterministic channel code with tests and running the build to verify that Telegram is properly registered as a first-class channel.