WhatsApp là nơi hội thoại diễn ra. Không phải Slack, không phải Discord, không phải Telegram — với phần lớn thế giới, WhatsApp là mặc định. Hai tỷ người dùng hoạt động hàng tháng, thống trị ở châu Âu, Mỹ Latin, Nam Á, và châu Phi. Nếu bạn muốn trợ lý AI thực sự là phần cuộc sống hàng ngày, nó cần ở nơi hội thoại hàng ngày của bạn đã diễn ra.
Vấn đề là WhatsApp không cung cấp bot API cho cá nhân. WhatsApp Business API tồn tại, nhưng yêu cầu tài khoản doanh nghiệp, phê duyệt từ Meta, và cấu trúc phí theo tin nhắn thiết kế cho chăm sóc khách hàng, không phải trợ lý cá nhân. Với lập trình viên muốn bot AI cá nhân trong WhatsApp — bot phản hồi trong nhóm chat, nhớ ngữ cảnh, và chạy trên phần cứng riêng — con đường chính thức là ngõ cụt.
NanoClaw giải quyết điều này với Baileys, thư viện WhatsApp Web mã nguồn mở kết nối đến server WhatsApp giống cách WhatsApp Web client làm. Bạn quét mã QR, kết nối được thiết lập, và NanoClaw có thể gửi nhận tin nhắn dưới tài khoản WhatsApp của bạn. Không cần Business API, không cần phê duyệt Meta, không phí theo tin nhắn.
Kiến Trúc: Tại Sao WhatsApp Đặc Biệt
Tích hợp WhatsApp của NanoClaw không chỉ là cầu nối tin nhắn — đó là kênh chính mà toàn bộ kiến trúc được thiết kế xung quanh. Trong khi các kênh khác (Telegram, Discord, Slack) được thêm qua Claude Code skills, WhatsApp được tích hợp vào lõi. Đây không phải thiên vị; mà phản ánh cách mô hình nhóm WhatsApp ánh xạ tự nhiên vào mô hình bảo mật của NanoClaw.
Nhóm WhatsApp là ranh giới cách ly. Mỗi nhóm có container riêng, file bộ nhớ CLAUDE.md riêng, và workspace ghi được riêng. Khi ai đó gửi tin nhắn trong nhóm gia đình, agent phản hồi chỉ có quyền truy cập lịch sử và bộ nhớ của nhóm đó. Nó không thể thấy tin nhắn từ nhóm công việc, không thể truy cập lịch sử chat riêng tư, và không thể đọc file thuộc nhóm khác. Cách ly được thực thi bởi container mount, không phải logic ứng dụng.
Cách ly theo nhóm này là thứ khiến NanoClaw an toàn cho cách mọi người thực sự dùng WhatsApp. Nhóm gia đình thảo luận chuyện cá nhân. Nhóm công việc thảo luận dự án độc quyền. Nhóm bạn bè chia sẻ những thứ họ không chia sẻ công khai. Mỗi ngữ cảnh cần tách biệt, và NanoClaw đảm bảo chúng tách biệt — không qua danh sách kiểm soát truy cập có thể có bug, mà qua tách biệt container vật lý không thể bị vượt qua bởi exploit cấp ứng dụng.
Cài Đặt
Quá trình cài đặt mất khoảng mười phút, phần lớn là đợi npm install.
Clone repository và cài dependency:
```bash git clone https://github.com/qwibitai/NanoClaw.git cd NanoClaw npm install ```
Cấu hình môi trường. Cấu hình tối thiểu chỉ cần Anthropic API key:
```bash echo 'ANTHROPIC_API_KEY=sk-ant-your-key-here' > .env ```
Chạy ghép nối WhatsApp:
```bash npm run auth ```
Lệnh này hiển thị mã QR trong terminal. Mở WhatsApp trên điện thoại, vào Thiết Bị Liên Kết, và quét mã. Kết nối được thiết lập, và NanoClaw bắt đầu lắng nghe tin nhắn.
Khởi động agent:
```bash npm start ```
Vậy thôi. Gửi tin nhắn đến bất kỳ nhóm WhatsApp nào bạn muốn bot hoạt động, nhắc tên trợ lý (cấu hình qua ASSISTANT_NAME trong .env), và nó phản hồi. Phản hồi đầu tiên mất vài giây khi container khởi tạo; các tin nhắn tiếp theo trong cùng phiên nhanh hơn vì container vẫn còn hoạt động.
Luồng Tin Nhắn
Hiểu luồng tin nhắn giúp giải thích tại sao NanoClaw cảm giác nhanh nhạy dù có overhead container. Khi tin nhắn đến trên WhatsApp, tiến trình host — lõi TypeScript ~500 dòng của NanoClaw — nhận qua Baileys. Nó kiểm tra tin nhắn có gửi cho trợ lý không (qua nhắc tên hoặc tin nhắn trực tiếp). Nếu có, host tra cứu trạng thái container của nhóm.
Nếu container đã chạy cho nhóm đó (từ hội thoại gần đây), tin nhắn được chuyển qua IPC. Agent bên trong container nhận tin nhắn, xử lý với Claude Agent SDK, và gửi phản hồi lại qua IPC. Host chuyển tiếp phản hồi đến WhatsApp. Tổng độ trễ thêm: vài mili giây cho IPC, cộng thời gian Claude API phản hồi.
Nếu không có container đang chạy, host khởi tạo một container. Trên macOS với Apple Container, mất 200-400ms. Trên Linux với Docker, 1-2 giây. Container nhận file bộ nhớ CLAUDE.md của nhóm, lịch sử hội thoại từ SQLite, và API key qua stdin. Nó xử lý tin nhắn và phản hồi. Container duy trì hoạt động trong thời gian timeout cấu hình được (mặc định: 30 phút) để xử lý tin nhắn tiếp theo mà không có overhead khởi tạo.
Kết quả là hầu hết tin nhắn — những tin đến trong hội thoại đang hoạt động — cảm giác tức thì. Thời gian phản hồi AI bị chi phối bởi độ trễ Claude API, không phải hạ tầng NanoClaw. Chỉ tin nhắn đầu tiên sau khoảng im lặng dài mới có overhead khởi tạo container, và ngay cả thế cũng đủ nhanh để người dùng hiếm khi nhận ra.
Bộ Nhớ Theo Nhóm: Tính Năng Khiến Nó Hữu Ích
File CLAUDE.md theo nhóm là thứ biến chatbot stateless thành trợ lý thực sự hữu ích. File bộ nhớ mỗi nhóm tích lũy ngữ cảnh theo thời gian — sở thích, dự án đang tiến hành, chủ đề thường xuyên, trò đùa nội bộ. Agent đọc file này ở đầu mỗi lượt hội thoại, nghĩa là nó nhớ điều bạn nói tuần trước mà bạn không cần nhắc lại.
Trong nhóm gia đình, bộ nhớ có thể ghi chú sở thích ăn uống, lịch học, và hoạt động định kỳ. Trong nhóm công việc, nó có thể theo dõi deadline dự án, sở thích đội, và quyết định kỹ thuật. Trong nhóm bạn bè, nó có thể nhớ kế hoạch du lịch, gợi ý nhà hàng, và sở thích chung.
Bộ nhớ có thể chỉnh sửa. Bạn có thể yêu cầu agent nhớ điều cụ thể ("nhớ rằng mẹ dị ứng hải sản") hoặc quên điều gì đó ("quên những gì tôi nói về bữa tiệc bất ngờ"). Bạn cũng có thể sửa file CLAUDE.md trực tiếp — đó là file văn bản thuần trên hệ thống file, không bị khóa trong database.
Thực Tế Về Quyền Riêng Tư
Chạy WhatsApp AI bot đặt ra câu hỏi chính đáng về quyền riêng tư, và đáng nói thẳng. Tin nhắn NanoClaw xử lý được gửi đến Anthropic API để Claude tạo phản hồi. Nghĩa là tin nhắn WhatsApp của bạn — ít nhất những tin gửi cho trợ lý — rời thiết bị và được xử lý bởi server Anthropic.
NanoClaw giảm thiểu điều này theo nhiều cách. Chỉ tin nhắn gửi rõ ràng cho trợ lý mới được gửi đến API — bot không xử lý hay lưu trữ tin nhắn không gửi cho nó. Lịch sử hội thoại lưu trong SQLite nằm trên máy bạn. File bộ nhớ CLAUDE.md nằm trên máy bạn. Và nếu bạn cấu hình NanoClaw dùng Ollama thay vì Anthropic, xử lý AI diễn ra cục bộ — không gì rời mạng của bạn.
Với hầu hết người dùng, tình trạng quyền riêng tư thực tế là: tin nhắn WhatsApp nằm trên thiết bị trừ khi bạn chủ động hỏi trợ lý AI, lúc đó tin nhắn cụ thể đó được gửi đến Anthropic (hoặc xử lý cục bộ với Ollama). Đó là câu chuyện quyền riêng tư tốt hơn đáng kể so với dịch vụ AI cloud xử lý và lưu trữ mọi thứ bạn gõ.
WhatsApp là nơi cuộc sống bạn diễn ra. NanoClaw đặt trợ lý AI ở đó — với mô hình cách ly, bộ nhớ, và quyền riêng tư khiến nó an toàn để dùng trong những nhóm nơi bạn thảo luận những điều thực sự quan trọng.