Chạy NanoClaw
Lõi TypeScript nhẹ, một cách cài đặt. Clone, chạy claude, dùng /setup.
checklist Yêu cầu hệ thống
Node.js 20+ (khuyên dùng LTS)
macOS hoặc Linux. Windows qua WSL2 có thể hoạt động nhưng không hỗ trợ chính thức.
512MB+ RAM. Runtime nhẹ, không biên dịch nặng.
~50MB đã cài (node_modules). Image container thêm ~500MB.
Bắt buộc: Apple Container (macOS) hoặc Docker (macOS/Linux). Bắt buộc: Claude Code CLI.
Cần internet cho lệnh gọi Anthropic API. Không có chế độ ngoại tuyến.
Clone repo và bắt đầu với Claude CLI. Chạy trong vài phút.
One-Liner
Requires Claude CLI. All platforms.
git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude Step-by-Step
Clone first, then configure. More control.
git clone https://github.com/qwibitai/NanoClaw.git cd NanoClaw && npm install # Run claude and use /setup for guided configuration # Or edit .env and src/index.ts directly verified Xác minh cài đặt
Chạy các lệnh này để xác nhận NanoClaw đã cài đặt đúng.
node -e "console.log(require('./package.json').version)" Sẽ in số phiên bản đã cài đặt.
npm test Chạy bộ kiểm thử (vitest) để xác minh phụ thuộc và chức năng cốt lõi.
claude Mở Claude Code. Chạy /setup trong phiên để cấu hình có hướng dẫn.
settings Cấu hình ban đầu
Claude Code xử lý cài đặt qua /setup. Đây là những gì nó cấu hình.
Cài đặt phụ thuộc
Claude Code chạy npm install và build image container (nanoclaw-agent:latest) với Chromium, agent-browser và Claude Code cài sẵn.
Xác thực
Đặt ANTHROPIC_API_KEY trong .env, hoặc xác thực qua Claude Code OAuth. Secret được truyền vào container lúc chạy, không bao giờ nạp vào process.env.
Kết nối WhatsApp
Chạy 'npm run auth' để ghép nối qua mã QR. WhatsApp là kênh tích hợp sẵn. Thêm Telegram, Discord hoặc Slack sau qua skill (/add-telegram, /add-discord, /add-slack).
Khởi động Agent
Chạy 'npm start' để khởi chạy NanoClaw. Nó kết nối WhatsApp, bắt đầu vòng lặp xử lý tin nhắn và bắt đầu xử lý tin nhắn trong container cách ly.
.env — NanoClaw không dùng file cấu hình. Để thay đổi, nói cho Claude Code biết bạn muốn gì. Codebase đủ nhỏ để Claude có thể sửa đổi an toàn.
system_update_alt Nâng cấp NanoClaw
Giữ NanoClaw cập nhật để nhận tính năng, tích hợp và bản vá bảo mật mới nhất.
cd NanoClaw && git pull && npm install cd NanoClaw && git pull && docker compose up --build Xem changelog tại github.com/qwibitai/nanoclaw/releases để biết có gì mới trong mỗi phiên bản.
build Khắc phục sự cố
Các vấn đề thường gặp và cách khắc phục.
Cần trợ giúp?
Tham gia cộng đồng để được hỗ trợ cài đặt và khắc phục sự cố.