Thêm kênh Telegram (add-telegram)
Skill gắn bot Telegram vào dự án NanoClaw: copy adapter, cài dependency, lưu token và ghép cặp chat bằng mã 4 số.
Tự động hóaTrung cấp★ 30,471⑂ 12,865Điểm AI 7/10Cập nhật lần cuối: 9 thg 8, 2026
Làm được gì
Skill tích hợp kênh Telegram cho agent NanoClaw, từ code đến xác thực:
- Copy adapter Telegram cùng helper pairing / sanitize markdown và các test từ branch
channels - Thêm một dòng import tự-đăng-ký vào
src/channels/index.tsvà đăng ký bướcpair-telegramtrongsetup/index.ts - Cài
@chat-adapter/telegram@4.29.0ghim đúng phiên bản (chính sách chuỗi cung ứng không cho dùng range haylatest) - Build và chạy test tích hợp
telegram-registration.test.tsđể kiểm chứng - Hướng dẫn tạo bot qua @BotFather, lưu token vào
.env(không ghi đè giá trị có sẵn), gọigetMeđể xác nhận token và lấy username bot - Restart service rồi ghép cặp bằng mã 4 số để lấy
telegram:<chatId>và user id chủ sở hữu
Mọi directive nc: đều idempotent nên chạy lại nhiều lần vẫn an toàn.
Phù hợp với ai
- Người self-host NanoClaw và muốn điều khiển agent qua Telegram
- Người đang ở giữa luồng
/setupvà cần gắn kênh chat - Ai muốn chat 1:1 hoặc trong nhóm nhỏ với agent
- Lưu ý: skill chỉ dùng được trong repo NanoClaw, không phải template bot Telegram tổng quát.
Ví dụ sử dụng
- Gắn kênh đầu tiên: yêu cầu "thêm kênh Telegram" → skill copy adapter, cài package, build, xin token BotFather, rồi bạn gửi 4 số cho bot để nối DM với agent
main. - Kết nối nhóm làm việc: mời bot vào group, tắt Group Privacy, chạy pairing với
--intent wire-to:folderđể đăng ký chat id âm (telegram:-100...). - Khắc phục sự cố: bot không trả lời thì chạy
pnpm exec vitest run src/channels/telegram-registration.test.ts; nếu xanh thì restart bằngbash setup/lib/restart.shvà xemlogs/nanoclaw.error.log.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục .claude/skills/add-telegram từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-telegram/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
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/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Clone repo NanoClaw (hoặc mở thư mục dự án bạn đã có):
git clone https://github.com/nanocoai/nanoclaw.git && cd nanoclaw - Skill nằm sẵn tại
.claude/skills/add-telegram/, chỉ cần mở Claude Code ở gốc repo là nó tự nhận. - Nếu muốn dùng ở nơi khác, copy sang thư mục skill cá nhân:
mkdir -p ~/.claude/skills/add-telegram && cp -r .claude/skills/add-telegram/* ~/.claude/skills/add-telegram/ - Chuẩn bị môi trường: Node.js,
pnpm,curl,jqvà đã chạypnpm installmột lần. - Mở Telegram, nhắn
@BotFather, gửi/newbot, làm theo hướng dẫn và copy token dạng123456:ABC-DEF.... - Trong Claude Code, nói "thêm kênh Telegram"; khi skill hỏi token thì dán vào.
- Sau khi service restart, terminal in mã 4 số — gửi đúng 4 số đó cho bot từ chat bạn muốn đăng ký (trong group thì thêm
@tên_botphía trước). - Ghép cặp xong, dùng
/init-first-agenthoặc/manage-channelsđể nối kênh với agent.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT