Files

gavrielc 9486d56b01 v2: make v2 the main entry point, move v1 to src/v1/

- Move all v1 files (index, router, container-runner, db, ipc, types,
  logger, channels/registry, and all utilities) to src/v1/ as a
  fully self-contained archive with no shared dependencies
- Rename v2 files to remove -v2 suffix (index-v2.ts → index.ts, etc.)
- Update all imports across v2 source, tests, and setup files
- Migrate shared utilities (config, env, container-runtime, mount-security,
  timezone, group-folder) from pino logger to v2 log module
- Migrate setup/ files from logger to log with argument order swap
- Container agent-runner: move v1 entry to v1/, rename v2 to index.ts
- Update setup skill to offer all 13 v2 channels
- Install all Chat SDK adapter packages
- dist/index.js now runs v2; dist/v1/index.js runs v1

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-09 11:40:36 +03:00

1.9 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.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.js';

Build

npm run build

Phase 3: Setup

Create Telegram Bot (if needed)

Open Telegram and search for @BotFather

Send /newbot and follow the prompts:

Bot name: Something friendly (e.g., "NanoClaw Assistant")

Bot username: Must end with "bot" (e.g., "nanoclaw_bot")

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:

Open @BotFather > /mybots > select your bot

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

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

1.9 KiB Raw Blame History