wangjunxiao/nanoclaw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
12af4510690ab7f9d63b0bc4413d8264fb659705
nanoclaw/.claude/skills/add-telegram-v2/SKILL.md
gavrielc 12af451069 v2: add Chat SDK channel adapters and skills for 11 platforms 
Thin wrapper adapters + SKILL.md for Slack, Telegram, GitHub, Linear,
Google Chat, Teams, WhatsApp Cloud API, Resend, Matrix, Webex, iMessage.
All follow the same pattern as discord-v2.ts: readEnvFile → create*Adapter
→ createChatSdkBridge → registerChannelAdapter.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-09 11:26:33 +03:00

2.0 KiB
Raw Blame History

name, description
name description
add-telegram-v2 Add Telegram channel integration to NanoClaw v2 via Chat SDK.

Add Telegram Channel (v2)

This skill adds Telegram support to NanoClaw v2 using the Chat SDK bridge.

Phase 1: Pre-flight

Check if src/channels/telegram-v2.ts exists and the import is uncommented in src/channels/index.ts. If both are in place, skip to Phase 3.

Phase 2: Apply Code Changes

Install the adapter package

npm install @chat-adapter/telegram

Enable the channel

Uncomment the Telegram import in src/channels/index.ts:

import './telegram-v2.js';

Build

npm run build

Phase 3: Setup

Create Telegram Bot (if needed)

  1. Open Telegram and search for @BotFather
  2. Send /newbot and follow the prompts:
    • Bot name: Something friendly (e.g., "NanoClaw Assistant")
    • Bot username: Must end with "bot" (e.g., "nanoclaw_bot")
  3. Copy the bot token (looks like 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)

Disable Group Privacy (for group chats)

Important for group chats: By default, Telegram bots only see @mentions and commands in groups. To let the bot see all messages:

  1. Open @BotFather > /mybots > select your bot
  2. Bot Settings > Group Privacy > Turn off

Configure environment

Add to .env:

TELEGRAM_BOT_TOKEN=your-bot-token

Sync to container: mkdir -p data/env && cp .env data/env/env

Build and restart

npm run build
launchctl kickstart -k gui/$(id -u)/com.nanoclaw  # macOS
# systemctl --user restart nanoclaw  # Linux

Phase 4: Verify

Send a message to your bot in Telegram (search for its username). For groups: add the bot to a group and send a message. The bot should respond within a few seconds.

Removal

  1. Comment out import './telegram-v2.js' in src/channels/index.ts
  2. Remove TELEGRAM_BOT_TOKEN from .env
  3. npm uninstall @chat-adapter/telegram
  4. Rebuild and restart