Add Telegram Channel (NanoClaw)
Wires a Chat SDK Telegram bot into a NanoClaw project — copying the adapter, pinning the dependency, storing the bot token, and pairing your chat with a 4-digit code.
AutomationIntermediate★ 30,471⑂ 12,865AI score 7/10Last updated: Aug 9, 2026
What it does
- Pulls the Telegram adapter plus pairing and markdown-sanitize helpers (and their tests) from NanoClaw's
channelsbranch into your tree. - Adds the self-registration import to
src/channels/index.tsand registers thepair-telegramloader in theSTEPSmap ofsetup/index.ts. - Installs
@chat-adapter/telegramat an exact pinned version (ranges andlatestare rejected), then builds and runstelegram-registration.test.tsto prove the wiring and dependency are live. - Walks the operator through creating a bot with @BotFather, validates the token format, stores it in
.env(set-if-absent), and callsgetMeto confirm it works and capture the bot handle. - Restarts the service, then runs the pairing handshake: it prints a 4-digit code you send from the chat you want registered, resolving
telegram:<chatId>and your owner user id. - Ships troubleshooting for rejected tokens, failing
getMe, stalled pairing, and Group Privacy hiding group messages.
Who it's for
- Developers running agents on NanoClaw who want to talk to them over Telegram.
- Anyone mid-
/setupor/init-first-agentwho needs a messaging channel attached. - Teams that want an idempotent, re-runnable integration procedure instead of manual patching.
Example uses
- "Add a Telegram bot to my NanoClaw instance" → files copied, dependency installed, build + registration test run.
- Paste a BotFather token: it's regex-validated, written to
.env, then verified viagetMeto fetch the bot username. - Register a group: after the restart, send
@yourbot 1234in the group to pair thetelegram:-100...address.
Caveat: this only works inside the NanoClaw repo (pnpm, the
setup/scripts, access to thechannelsbranch). Telegram threads are not supported.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-telegram/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
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.
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 && cp -r nanoclaw/.claude/skills/add-telegram ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/nanocoai/nanoclaw.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill in:
cp -r nanoclaw/.claude/skills/add-telegram ~/.claude/skills/ - Change into your NanoClaw project root:
cd nanoclaw(or your existing NanoClaw checkout). - Verify prerequisites:
pnpm installsucceeds andgit fetch origin channelscan reach thechannelsbranch. - Start Claude Code in that directory and ask it to "add the Telegram channel".
- When prompted, open Telegram, message @BotFather with
/newbot, and paste the resulting token back into the terminal. - Finally, send the 4-digit code shown in the terminal to your bot from the exact chat or group you want registered to finish pairing.
View source on GitHub ↗License: MIT