FAQ NanoClaw Agent AI

NanoClaw là trợ lý AI cá nhân mã nguồn mở, nhẹ, xây dựng trên Anthropic Claude Agent SDK. Agent chạy trong container Linux cách ly (Apple Container trên macOS, Docker trên macOS/Linux). WhatsApp tích hợp sẵn, kênh khác qua skill. Có bộ nhớ SQLite bền vững, tác vụ định kỳ, truy cập web, tự động hóa trình duyệt và Agent Swarm.

Chạy 'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude' và dùng /setup trong phiên Claude. Claude Code xử lý phụ thuộc, xác thực, thiết lập container và cấu hình dịch vụ. Yêu cầu Node.js 20+ và Claude Code.

NanoClaw đủ nhỏ để hiểu — một tiến trình, vài file mã nguồn, không microservice. Khác với framework cồng kềnh, bạn có thể đọc toàn bộ codebase. Agent chạy trong container Linux thực với cách ly hệ thống file, không phải sau kiểm tra quyền cấp ứng dụng.

NanoClaw chạy độc quyền trên Anthropic Claude Agent SDK. Claude Code được cài toàn cục bên trong mỗi container và xử lý mọi tương tác AI. SDK quản lý việc chọn mô hình nội bộ — NanoClaw thiết kế đơn nhà cung cấp.

WhatsApp là kênh tích hợp sẵn (qua thư viện Baileys, ghép nối mã QR). Telegram, Discord và Slack có thể thêm qua skill Claude Code — chạy /add-telegram, /add-discord hoặc /add-slack. Skill sửa đổi mã nguồn fork của bạn để thêm hỗ trợ kênh sạch, chuyên dụng.

Bảo mật là nguyên tắc thiết kế cốt lõi. Agent chạy trong container Linux (Apple Container trên macOS, Docker trên macOS/Linux) với cách ly hệ thống file — không phải sau kiểm tra quyền cấp ứng dụng. Secret được truyền qua stdin JSON và không bao giờ nạp vào process.env. Danh sách cho phép mount với phát hiện thoát symlink. Container chạy không phải root với mount dự án chỉ đọc.

NanoClaw dùng SQLite (better-sqlite3) cho lưu trữ bền vững — tin nhắn, nhóm, phiên, tác vụ định kỳ và trạng thái router. Mỗi nhóm cũng có file CLAUDE.md riêng cho bộ nhớ theo nhóm, được mount vào container. Không cần cơ sở dữ liệu bên ngoài.

Có. NanoClaw chạy trên macOS và Linux — bất cứ đâu Node.js 20+ và Docker chạy được. Lõi TypeScript nhẹ hoạt động trên thiết bị tài nguyên thấp bao gồm Raspberry Pi. Yêu cầu container runtime (Apple Container hoặc Docker) và khóa Anthropic API.

Agent Swarm cho phép NanoClaw tạo nhóm agent chuyên biệt cộng tác xử lý tác vụ phức tạp. NanoClaw là trợ lý AI cá nhân đầu tiên hỗ trợ agent swarm, xây dựng trên khả năng agent-teams của Claude Code.

Dự án mã nguồn mở theo giấy phép MIT tại github.com/qwibitai/nanoclaw. Xem README để biết hướng dẫn đóng góp. Mọi đóng góp đều được chào đón.

Công cụ tích hợp sẵn được cung cấp bởi Claude Code chạy bên trong container: lệnh shell, đọc/ghi file, tìm kiếm web, duyệt web (Chromium) và ủy quyền agent (swarm). Tiến trình host cung cấp tác vụ định kỳ (cron), bộ nhớ SQLite bền vững và nhắn tin WhatsApp. Mở rộng chức năng bằng cách thêm skill.

Có. Mỗi container agent có Chromium cài sẵn và agent-browser cho tự động hóa trình duyệt. Claude Code có thể tìm kiếm web và duyệt trang để lấy thông tin thời gian thực bên trong container sandbox.

Repository chính thức và duy nhất đáng tin cậy là github.com/qwibitai/nanoclaw. Discord cộng đồng là discord.gg/VDdww8qS42.

macOS và Linux. Yêu cầu Node.js 20+ và container runtime — Apple Container trên macOS hoặc Docker trên macOS/Linux. Windows không được hỗ trợ chính thức nhưng có thể hoạt động qua WSL2 với Docker.

NanoClaw sử dụng Anthropic Claude độc quyền qua Claude Agent SDK. Đặt ANTHROPIC_API_KEY trong file .env, hoặc xác thực qua Claude Code OAuth. Không có hỗ trợ đa nhà cung cấp — SDK xử lý việc chọn mô hình nội bộ.

README trong repository GitHub (github.com/qwibitai/nanoclaw) là nguồn tài liệu chính. Thư mục docs/ chứa đặc tả kiến trúc, mô hình bảo mật và danh sách kiểm tra debug. Codebase đủ nhỏ để bạn có thể nhờ Claude Code hướng dẫn qua.

Kênh chính thức: Discord (discord.gg/VDdww8qS42) và GitHub (github.com/qwibitai/nanoclaw). Xem README để biết tất cả liên kết cộng đồng.