Add Telegram Channel (add-telegram)

Wires a Telegram bot into a NanoClaw install — copies the adapter, pins the dependency, stores the token, and pairs your chat with a 4-digit code.

AutomationIntermediate★ 30,471⑂ 12,865AI score 7/10Last updated: Aug 9, 2026

What it does

This skill adds Telegram support to a NanoClaw deployment end to end:

Copies the Telegram adapter plus pairing / markdown-sanitize helpers and their tests from the channels branch
Appends the self-registration import to src/channels/index.ts and registers the pair-telegram step in setup/index.ts
Installs @chat-adapter/telegram@4.29.0 at an exact pinned version (ranges and latest are rejected by policy)
Builds and runs telegram-registration.test.ts as the single integration check
Walks you through BotFather bot creation, stores the token in .env (set-if-absent), and verifies it with getMe while capturing the bot username
Restarts the service, then runs a 4-digit pairing handshake to resolve telegram:<chatId> and your owner user id

All nc: directives are idempotent, so the whole skill is safe to re-run after a partial failure.

Who it's for

Self-hosters running NanoClaw who want to talk to their agent from Telegram
Anyone in the middle of the /setup flow that needs a chat channel attached
Users who prefer DMs or small group chats over threaded platforms
Note: this is repo-specific tooling for NanoClaw, not a generic Telegram bot starter.

Examples

First channel setup: ask "add the Telegram channel" — the skill copies files, installs the package, builds, collects the BotFather token, then you send 4 digits to the bot to bind your DM to the main agent.
Group wiring: invite the bot to a team group, turn Group Privacy off, and pair with --intent wire-to:folder to register the negative chat id (telegram:-100...).
Debugging silence: if messages get no reply, run pnpm exec vitest run src/channels/telegram-registration.test.ts; if green, bash setup/lib/restart.sh and inspect logs/nanoclaw.error.log for token errors.

· · · Install guide · · ·

Install in the Claude app (no terminal)

Download the ZIP with the button below.
In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.

↓ Download ZIP

Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the .claude/skills/add-telegram folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/add-telegram/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills/add-telegram && cp -r nanoclaw/.claude/skills/add-telegram/* ~/.claude/skills/add-telegram/

⚠ This is a third-party skill. Check the source repository before installing.

Clone the NanoClaw repo (or open your existing checkout): git clone https://github.com/nanocoai/nanoclaw.git && cd nanoclaw
The skill already ships inside the repo at .claude/skills/add-telegram/, so launching Claude Code from the repo root picks it up automatically.
To make it available globally, copy it into your personal skills folder: mkdir -p ~/.claude/skills/add-telegram && cp -r .claude/skills/add-telegram/* ~/.claude/skills/add-telegram/
Prerequisites: Node.js with pnpm, plus curl and jq, and one completed pnpm install.
In Telegram, message @BotFather, send /newbot, follow the prompts, and copy the token (123456:ABC-DEF...).
In Claude Code, say "add the Telegram channel" and paste the token when prompted.
After the service restarts, a 4-digit code prints in the terminal — send exactly those digits to the bot from the chat you want registered (prefix with @yourbot in a group with Group Privacy on).
Once paired, finish wiring with /init-first-agent or /manage-channels.

View source on GitHub ↗License: MIT