NanoClaw - NanoClaw Trợ lý AI cá nhân mã nguồn mở siêu nhẹ ~3.900 dòng code

NanoClaw Trợ lý AI cá nhân mã nguồn mở siêu nhẹ ~3.900 dòng code

Tìm hiểu NanoClaw - trợ lý AI cá nhân mã nguồn mở siêu nhẹ chỉ 3.900 dòng code hoạt động mượt mà chạy local mới nhất năm 2026. Đọc ngay!

Trong làn sóng các AI agent mã nguồn mở, NanoClaw nổi lên như một luồng gió mới với triết lý hoàn toàn khác: tối giản đến cùng. Trong khi OpenClaw có hơn 3.680 file nguồn và 434.453 dòng code, NanoClaw chỉ gồm ~15 file và ~3.900 dòng code — đủ nhỏ để một người có thể hiểu toàn bộ trong 8 phút. Được xây dựng bởi NanoCo (đã gọi vốn $12M) trên nền tảng Claude Agent SDK, NanoClaw là trợ lý AI cá nhân mã nguồn mở, siêu nhẹ, chạy trên máy người dùng. Một AI agent siêu nhẹ đúng nghĩa mà ai cũng có thể tự host.

NanoClaw là gì?

NanoClaw là một trợ lý AI cá nhân mã nguồn mở, được thiết kế theo triết lý “bespoke software” — phần mềm được làm riêng cho từng người dùng. Bạn fork repo, chạy một script duy nhất, và có một AI assistant mã nguồn mở kết nối với WhatsApp, Telegram, Discord, Slack và hàng loạt ứng dụng chat khác. Đây là một trong những AI agent siêu nhẹ dễ tiếp cận nhất hiện nay.

Dự án có hơn 29.9k sao GitHub và đã xuất hiện trên VentureBeat, Fortune, The New Stack, và CNBC. Giấy phép MIT hoàn toàn miễn phí — bạn có thể fork, tùy chỉnh, và chạy mà không lo bị khóa vào bất kỳ dịch vụ nào.

Triết lý thiết kế của NanoClaw

NanoClaw được xây dựng dựa trên 6 nguyên tắc thiết kế rõ ràng — phản ánh tư duy của một mã nguồn mở AI agent hiện đại:

  1. Đủ nhỏ để hiểu được — Một tiến trình duy nhất, vài file nguồn, không microservices
  2. Bảo mật bằng cô lập (isolation) — Agent chạy trong container Linux, không phải trên máy host
  3. Xây cho người dùng cá nhân — Bespoke software, fork và tùy chỉnh dễ dàng
  4. AI-native, hybrid — Script hóa nhanh, Claude Code xử lý các quyết định phức tạp
  5. Skills thay vì tính năng cứng — Channel và provider được cài theo yêu cầu
  6. Dây cương tốt nhất, mô hình tốt nhất — Claude Code SDK mặc định, provider khác là tùy chọn

So sánh NanoClaw vs OpenClaw — Sự khác biệt về quy mô

Con số biết nói nhất là sự khác biệt về quy mô codebase giữa NanoClaw và OpenClaw — một mã nguồn mở AI agent phổ biến khác:

Tiêu chíNanoClawOpenClaw
File nguồn~153,680
Dòng code~3,900434,453
Dependencies<1070
File cấu hình053
Thời gian hiểu toàn bộ codebase8 phút1–2 tuần
Mô hình bảo mậtCô lập container OSKiểm tra cấp ứng dụng
Kiến trúcMột tiến trình + containerMột tiến trình, bộ nhớ chia sẻ

Đây chính là điểm mạnh của AI agent siêu nhẹ: ít code hơn đồng nghĩa với ít lỗi hơn, dễ kiểm tra bảo mật hơn, và dễ đóng góp hơn.

Kiến trúc: Một tiến trình + Container

Kiến trúc của NanoClaw cực kỳ đơn giản nhưng hiệu quả — đúng chất một AI agent siêu nhẹ:

  1. Ứng dụng nhắn tin gửi tin nhắn đến Router
  2. Router ghi vào inbound.db (SQLite)
  3. Container (Bun + Agent SDK) xử lý: CLAUDE.md riêng, bộ nhớ riêng, skills riêng, mount giới hạn
  4. Kết quả ghi vào outbound.db
  5. Delivery gửi streamed reply qua kênh nhắn tin tương ứng

Không microservices, không message brokers. Một Node host duy nhất xử lý tuyến đường theo mô hình entity: user → messaging group → agent group → session. NanoClaw chứng minh rằng một trợ lý AI cá nhân không cần kiến trúc phức tạp mới hoạt động tốt.

Các file chính trong codebase

Với chỉ ~15 file, NanoClaw là AI assistant mã nguồn mở dễ đọc nhất hiện nay:

FileChức năng
src/index.tsEntry point — khởi tạo DB, channel adapters, delivery poll
src/container-runner.tsKhởi tạo container per agent group, inject credential OneCLI
src/router.tsĐịnh tuyến inbound: user → agent group → session → inbound.db
src/delivery.tsPoll outbound.db, gửi qua adapter, xử lý system actions
src/db/DB trung tâm — users, roles, agent groups, messaging groups
src/host-sweep.tsSweep 60 giây — phát hiện stale tasks, recurrence

Bảo mật cấp container — Khác biệt lớn nhất

Điểm khác biệt lớn nhất của NanoClaw so với OpenClaw là mô hình bảo mật. OpenClaw kiểm tra bảo mật ở cấp ứng dụng (application-level checks), còn NanoClaw cô lập toàn bộ agent trong container Linux. Mỗi agent group có:

  • Container riêng với filesystem và process space riêng
  • CLAUDE.md riêng, bộ nhớ riêng, skills riêng
  • Chỉ được mount những thư mục bạn cho phép
  • Credential không bao giờ vào container — OneCLI’s Agent Vault inject tại thời điểm request

“Nothing crosses the boundary unless you wire it to.” — không gì vượt qua ranh giới trừ khi bạn chủ động kết nối. Đây là chuẩn bảo mật mà mọi trợ lý AI cá nhân nên có.

Đa kênh nhắn tin — Kết nối mọi nơi

NanoClaw hỗ trợ nhiều kênh giao tiếp, cài đặt theo yêu cầu với lệnh /add-<tên>:

  • WhatsApp, Telegram, Discord, Slack, Microsoft Teams
  • iMessage, Matrix, Google Chat, Webex
  • Linear, GitHub, WeChat
  • Email (qua Resend)

Đây là một trong những lý do NanoClaw được 29.9K người dùng GitHub yêu thích — khả năng kết nối linh hoạt mà không phải hy sinh sự đơn giản.

Cô lập linh hoạt V2

Mỗi channel có thể kết nối với agent riêng (bảo mật tối đa) hoặc nhiều channel dùng chung một agent (bộ nhớ thống nhất), hoặc gộp nhiều channel vào một phiên chia sẻ. Bạn có toàn quyền quyết định mức độ cô lập cho AI assistant mã nguồn mở của mình.

Cài đặt NanoClaw — Chỉ 3 dòng lệnh

Việc cài đặt NanoClaw cực kỳ đơn giản — đúng chất một AI agent siêu nhẹ:

git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash nanoclaw.sh

Script tự động cài Node, pnpm, Docker, đăng ký Anthropic credential với OneCLI, build container agent, và ghép nối channel đầu tiên. Nếu bước nào lỗi, Claude Code tự động chẩn đoán và tiếp tục.

Yêu cầu: macOS, Linux, hoặc Windows (WSL2), Node.js 20+, pnpm 10+, Claude Code, Docker.

Chi tiết cài đặt có thể xem trên GitHub repository của NanoClaw.

So sánh: NullClaw vs NanoClaw vs OpenClaw

Tiêu chí OpenClaw NullClaw NanoClaw
Ngôn ngữ TypeScript Zig TypeScript (Bun)
Dòng code 434K ~50K (ước) ~3.9K
Kích thước binary ~28 MB 678 KB ~15 files
Bảo mật App-level checks 6 lớp OS-level Container isolation
Cài đặt npm / curl brew / zig build bash script
Hỗ trợ LLM Anthropic, OpenAI, local 22+ providers Claude SDK, tùy chọn khác
Tài trợ chính OpenAI, NVIDIA, GitHub Cộng đồng NanoCo ($12M)

NanoClaw trong hệ sinh thái Claw

NanoClaw là một phần của gia đình Claw Ecosystem rộng lớn hơn — nơi mỗi thành viên là một AI agent mã nguồn mở với thế mạnh riêng:

  • OpenClaw — AI agent đa kênh TypeScript, tài trợ bởi OpenAI, GitHub, NVIDIA
  • ZeroClaw — Agent runtime Rust, single binary, 20+ LLM providers
  • NullClaw — AI assistant Zig siêu nhẹ 678KB, 6 lớp bảo mật
  • PicoClaw — Trợ lý AI Go, dưới 10MB RAM, chạy Android & RISC-V
  • TinyClaw — Framework modular với Heartware Personality Engine

Xem thêm bài So sánh 6 Claw Ecosystem để có cái nhìn tổng quan và chọn giải pháp phù hợp nhất.

Kết luận: NanoClaw có đáng dùng không?

Sau khi tìm hiểu kỹ, mình đánh giá NanoClaw đại diện cho một hướng tiếp cận hoàn toàn khác trong thế giới mã nguồn mở AI agent: tối giản, dễ hiểu, và an toàn bằng cô lập thay vì kiểm tra. Với chỉ ~3.900 dòng code và ~15 file nguồn, đây là codebase trợ lý AI cá nhân dễ tiếp cận nhất hiện nay. Nếu bạn muốn một AI assistant mã nguồn mở mà bạn thực sự có thể hiểu và tùy chỉnh, NanoClaw là lựa chọn hàng đầu.

Bạn đã dùng NanoClaw chưa? So với các AI agent mã nguồn mở khác thì thế nào? Chia sẻ dưới phần bình luận nhé!

Bài viết liên quan