Thêm kênh WhatsApp (NanoClaw)
Skill cài đặt kênh WhatsApp gốc bằng Baileys cho NanoClaw, xác thực bằng mã QR hoặc mã ghép nối.
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ì
Đây là skill tự động hoá việc thêm adapter kênh WhatsApp vào dự án NanoClaw. Kết nối trực tiếp qua Baileys (WhatsApp Web), không cần cầu nối Chat SDK, và hướng dẫn/thực thi tuần tự:
- Sao chép
src/channels/whatsapp.ts, test đăng ký và skill định dạng WhatsApp từ nhánhchannels - Thêm một dòng import tự-đăng-ký vào
src/channels/index.ts - Cài đúng phiên bản
@whiskeysockets/baileys,qrcode,pino - Build và chạy test tích hợp đăng ký kênh
- Liên kết thiết bị bằng QR trong terminal, mã ghép nối 8 ký tự, hoặc QR mở trên trình duyệt
- Xác định chế độ số riêng / số cá nhân rồi ghi
ASSISTANT_HAS_OWN_NUMBER,ASSISTANT_NAMEvào.env - Khởi động lại service, lấy JID cho cuộc trò chuyện DM, kiểm tra lại các wiring nhóm cũ bị spam
Điểm đáng chú ý: skill bắt buộc cảnh báo rủi ro bị WhatsApp khóa số nếu dùng số cá nhân và không cho tiếp tục khi người dùng chưa xác nhận rõ ràng.
Phù hợp với ai
- Người đang tự chạy NanoClaw và muốn chat với agent qua WhatsApp
- Người đã có SIM/eSIM dự phòng làm số riêng cho bot
- Lập trình viên quen terminal, pnpm, systemd (mức trung cấp trở lên)
Lưu ý: đây không phải skill dùng chung cho mọi dự án, nó gắn chặt với cấu trúc repo NanoClaw.
Ví dụ sử dụng
- Bot có số riêng — liên kết eSIM dự phòng bằng QR, khai báo số cá nhân của bạn làm số để chat; agent xuất hiện như một liên hệ độc lập.
- Chế độ self-chat trên số cá nhân — sau khi chấp nhận rủi ro, agent chỉ sống trong cuộc trò chuyện "Bạn" và chỉ trả lời tin nhắn bắt đầu bằng
@TênAgent. - Cài trên server không màn hình — skill phát hiện môi trường headless và chuyển sang mã ghép nối; nếu QR trong terminal quá nhỏ, chạy
wa-qr-browser.tsđể hiện QR lớn trên trình duyệt.
· · · 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-whatsapp từ repo GitHub nanocoai/nanoclaw vào ~/.claude/skills/add-whatsapp/ 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 /tmp/nanoclaw && cp -r /tmp/nanoclaw/.claude/skills/add-whatsapp ~/.claude/skills/add-whatsapp⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Chuẩn bị dự án NanoClaw (Node 20+,
pnpm). Skill này chỉ có ý nghĩa bên trong repo NanoClaw. - Clone repo:
git clone https://github.com/nanocoai/nanoclaw.git - Sao chép skill vào thư mục skill của Claude:
cp -r nanoclaw/.claude/skills/add-whatsapp ~/.claude/skills/add-whatsapp(hoặc dùng trực tiếp trong repo). - Mở Claude Code tại thư mục gốc dự án và gõ
/add-whatsapp. - Ở bước kiểm tra an toàn số điện thoại, chọn
dedicated(khuyến nghị) hoặcshared. Nếu chọnshared, hãy đọc kỹ cảnh báo nguy cơ bị khóa tài khoản và xác nhận rõ ràng. - Cho phép skill sao chép adapter, cài dependency, build và chạy test.
- Chọn cách xác thực:
qr(quét bằng camera) hoặcpairing-code(nhập số điện thoại, chỉ chữ số, có mã quốc gia). Trên điện thoại: WhatsApp → Cài đặt → Thiết bị đã liên kết → Liên kết thiết bị, hoàn tất trong ~60 giây. - Nhập tên agent và (nếu dùng số riêng) số cá nhân của bạn;
.envsẽ được cập nhật và service khởi động lại. - Nếu lỗi, chạy
rm -rf store/auth/rồi thử lại bước xác thực; xem mục Troubleshooting nếu vẫn thất bại.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT