campaign Thông báo

info Giới thiệu

NanoClaw là trợ lý AI cá nhân nhẹ, hoàn toàn tự chủ, 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 Linux/macOS). WhatsApp tích hợp sẵn, kênh khác qua skill. Bộ nhớ SQLite bền vững, tác vụ định kỳ, truy cập web và Agent Swarm.

download Cài đặt

NanoClaw là dự án TypeScript. Clone repo và cài đặt với npm.

npm / Claude CLI

# macOS / Linux — clone and setup
git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw
claude
# Then run /setup in the Claude session

# Or install Claude CLI first:
npm install -g @anthropic-ai/claude-code

Cài đặt nhanh (Khuyên dùng)

git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw
claude
# Run /setup inside the Claude session

# With environment variables pre-configured:
ANTHROPIC_API_KEY="sk-..." claude

# Quick start after setup:
npm start

Build & Cài đặt thủ công

git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw
npm install
# Edit src/index.ts to configure your settings
npm start

Dự phòng dev: chạy 'npm run dev' cho chế độ phát triển với hot reload.

rocket_launch Bắt đầu nhanh

Chạy onboarding một lần để thiết lập cấu hình, sau đó bắt đầu chat.

# Clone and setup
git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw && npm install

# Run setup wizard
npm run setup

# Start NanoClaw
npm start

# Development mode (hot reload)
npm run dev

# Run tests
npm test

Cấu hình được thực hiện bằng cách chỉnh sửa mã nguồn trực tiếp. Khóa API đặt trong .env, cấu hình kênh trong src/index.ts.

terminal Lệnh

NanoClaw sử dụng npm script cho mọi quy trình.

forum Kênh

WhatsApp là kênh tích hợp sẵn (qua thư viện Baileys). Các kênh khác — Telegram, Discord, Slack — có thể thêm qua skill Claude Code (/add-telegram, /add-discord, /add-slack). Mỗi nhóm có container cách ly riêng và bộ nhớ CLAUDE.md.

# WhatsApp (built-in via Baileys library)
# Run 'npm run auth' to pair via QR code
# Per-group containers with isolated CLAUDE.md memory

# Add more channels via Claude Code skills:
# /add-telegram — Telegram bot support
# /add-discord — Discord gateway support
# /add-slack — Slack Events API support

# Start the agent (connects WhatsApp)
npm start

Mẹo: Chạy /add-telegram hoặc /add-discord trong Claude Code để thêm kênh. Skill sửa đổi mã nguồn fork của bạn trực tiếp.

build Công cụ

Công cụ là khả năng agent có thể gọi trong cuộc hội thoại. Tất cả công cụ tích hợp sẵn được sandbox và giới hạn trong workspace mặc định.

# Built-in tools (provided by Claude Code inside containers):
# shell commands, file read/write, web search,
# web browsing (Chromium + agent-browser),
# agent delegation (swarms)

# Host-provided capabilities:
# SQLite memory, scheduled tasks (cron),
# WhatsApp messaging, IPC between host and containers

# Container image includes Chromium and agent-browser
# Apple Container on macOS, Docker on Linux

database Hệ thống bộ nhớ

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

# SQLite database (better-sqlite3)
# Messages, groups, sessions, scheduled tasks, router state

# Per-group CLAUDE.md memory files
# Mounted into each group's container

# IPC via filesystem between host and containers
# No external database — everything is local

settings Cấu hình

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. Khóa API đặt trong .env, mọi thứ khác trong mã nguồn.

# NanoClaw doesn't use configuration files
# To make changes, tell Claude Code what you want

# Key files:
# src/index.ts — orchestrator, state, message loop
# src/config.ts — constants, trigger pattern, paths
# .env — API key and runtime settings

# Environment variables:
ANTHROPIC_API_KEY="sk-ant-..."
ASSISTANT_NAME="Andy"
CONTAINER_IMAGE="nanoclaw-agent:latest"

model_training Nhà cung cấp AI

NanoClaw chạy độc quyền trên Anthropic Claude Agent SDK. Claude Code chạy bên trong mỗi container, cung cấp mọi khả năng AI.

NanoClaw thiết kế đơn nhà cung cấp. Claude Agent SDK xử lý việc chọn mô hình nội bộ. Đặt ANTHROPIC_API_KEY trong .env hoặc xác thực qua Claude Code OAuth.

key Biến môi trường

Biến môi trường được cấu hình trong file .env cục bộ. Secret được đọc theo yêu cầu và không bao giờ nạp vào process.env.

# Required
ANTHROPIC_API_KEY=sk-ant-...

# Optional
ASSISTANT_NAME=Andy
ASSISTANT_HAS_OWN_NUMBER=false
CONTAINER_IMAGE=nanoclaw-agent:latest
CONTAINER_TIMEOUT=1800000
TZ=America/New_York

shield Bảo mật

Agent chạy trong container, không phải sau kiểm tra quyền cấp ứng dụng. Chúng chỉ có thể truy cập thư mục được mount rõ ràng.

# Container isolation (Apple Container / Docker)
# Each agent runs in its own Linux container

# Secrets passed via stdin JSON, never in process.env
# Mount allowlists with symlink escape detection
# Containers run as non-root with read-only project mounts

account_tree Kiến trúc

Một tiến trình Node.js. Agent thực thi trong container Linux cách ly với cách ly hệ thống file. Hàng đợi tin nhắn theo nhóm với kiểm soát đồng thời. IPC qua hệ thống file.

code Phát triển

Quy trình TypeScript/Node.js tiêu chuẩn. Chạy 'npm run dev' cho phát triển với hot reload.

# Clone the repo
git clone https://github.com/qwibitai/NanoClaw.git
cd NanoClaw

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

menu_book Trung tâm tài liệu

Để xem tài liệu chuyên sâu, tham khảo thư mục docs trong repository chính thức.

git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude