add-telegram

Add Telegram bot integration to NanoClaw for message ingestion and replies.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Adds first-class Telegram integration to NanoClaw so users can register chats, receive inbound messages, and send agent responses from Telegram without exposing the host environment directly.

Core Features & Use Cases

  • Deterministic code changes: Adds channel implementation files, tests, and imports via the skills engine so changes are reproducible.
  • Interactive setup: Guides users to create or supply a Telegram bot token, sync environment variables to container data, and register chats as main or trigger-only channels.
  • Robust message handling: Delivers text and media placeholders, translates @mentions into assistant triggers, supports chat metadata discovery, and gracefully handles errors and message length limits.

Quick Start

Run the add-telegram skill and follow the interactive prompts to create or provide a Telegram bot token 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 integrate a Telegram bot with NanoClaw for messaging?

To integrate a Telegram bot with NanoClaw, run the add-telegram skill to generate channel implementation files. You will need a Telegram bot token and the grammy npm dependency to enable secure message ingestion and outbound replies.

What do I need to set up Telegram bot notifications in NanoClaw?

Setting up Telegram bot notifications requires a Telegram bot token, the grammy npm dependency, and synced environment variables in the container. You must also pass unit tests and a clean build before activating the message ingestion channel.

Can I register specific Telegram chats as trigger-only channels?

Yes, you can register Telegram chats as either main or trigger-only channels. The integration translates @mentions into assistant triggers, allowing specific chats to activate the agent without exposing the host environment directly.

How does the Telegram channel handle media and long messages?

The Telegram channel handles media by delivering media placeholders and gracefully handles errors and message length limits. It ensures robust message processing for text and media without breaking the chat registration flow.

Does the Telegram integration require manual code changes to the NanoClaw environment?

No, the integration applies deterministic code changes automatically via the skills engine. It adds channel implementation files, tests, and imports reproducibly, ensuring your NanoClaw environment remains stable without manual file edits.

Why is my Telegram bot integration failing to pass the build phase?

Telegram bot integration fails the build phase if unit tests are not passing or if environment variables are not synced into the container data. The skill requires a clean build and successful tests before activating the channel.