Thêm kênh WeChat (NanoClaw)

Hướng dẫn cài đặt và đấu nối kênh WeChat cá nhân vào NanoClaw qua iLink Bot API chính thức của Tencent, đăng nhập bằng quét QR.

Tự động hóaNâng cao★ 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 dẫn dắt toàn bộ quy trình kết nối tài khoản WeChat cá nhân làm kênh nhắn tin cho host agent NanoClaw.

Lấy adapter src/channels/wechat.ts và test đăng ký từ nhánh channels
Thêm dòng import tự đăng ký vào src/channels/index.ts, cài wechat-ilink-client@0.1.0 (pin phiên bản)
Build và chạy test để xác nhận kênh wechat thật sự có trong registry
Bật WECHAT_ENABLED=true, khởi động lại service, lấy QR từ log hoặc data/wechat/qr.txt và quét bằng điện thoại
Dùng script wire-dm.ts để nối tin nhắn DM đầu tiên với agent group (có chế độ tương tác và non-interactive)
Ghi chú vận hành: đăng nhập lại khi hết phiên, không chạy hai instance cùng token, quản lý con trỏ đồng bộ

Khác với wechaty/PadLocal, đây là API first-party của Tencent nên không cần token trả phí, không cần webhook công khai và không rủi ro khóa tài khoản.

Phù hợp với ai

Người đang vận hành NanoClaw và muốn chat với agent qua WeChat
Ai chạy server nội bộ/home server không thể mở webhook công khai
Ai muốn thử bot WeChat cá nhân mà không vi phạm điều khoản

Ví dụ sử dụng

"Thêm kênh WeChat cho NanoClaw" → skill kiểm tra trạng thái, copy adapter, cài dependency, build và chạy test.
Sau khi quét QR, dùng tài khoản WeChat khác nhắn cho bot để tự tạo messaging group, rồi chạy wire-dm.ts --non-interactive --agent-group ag-xxxxx.
Khi log hiện WeChat: session expired, xóa data/wechat/auth.json và khởi động lại để quét QR mới.

· · · Hướng dẫn cài đặt · · ·

Dùng thử ngay, không cần cài

Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.

Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình:
https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/add-wechat/SKILL.md

Mình muốn: (viết việc bạn cần ở đây)

Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.

↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.

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.

↓ Tải ZIP

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-wechat từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-wechat/ 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 && cp -r nanoclaw/.claude/skills/add-wechat ~/.claude/skills/

⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.

Bạn cần có sẵn dự án NanoClaw trên máy; nếu chưa, chạy git clone https://github.com/nanocoai/nanoclaw.git rồi cd nanoclaw.
Skill đã nằm trong .claude/skills/add-wechat của repo. Nếu muốn dùng ở nơi khác: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-wechat ~/.claude/skills/.
Cài Node.js >= 20 và pnpm.
Mở Claude Code tại thư mục gốc dự án và yêu cầu "thêm kênh WeChat" để kích hoạt skill.
Theo hướng dẫn, thêm WECHAT_ENABLED=true vào .env và restart service.
Mở URL trong data/wechat/qr.txt bằng trình duyệt và quét QR bằng app WeChat trên điện thoại.
Nhờ một tài khoản WeChat khác nhắn cho bot, sau đó chạy pnpm exec tsx .claude/skills/add-wechat/scripts/wire-dm.ts để đấu nối agent.
Không commit data/wechat/auth.json vì đây là thông tin xác thực.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT