campaign 公告

info 简介

NanoClaw 是一个轻量级、完全自主的个人 AI 助手，基于 Anthropic Claude Agent SDK 构建。代理运行在隔离的 Linux 容器中（macOS 上使用 Apple Container，Linux/macOS 上使用 Docker）。内置 WhatsApp，其他渠道通过技能添加。持久化 SQLite 记忆、定时任务、网页访问和代理集群。

download 安装

NanoClaw 是一个 TypeScript 项目。克隆仓库并使用 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

快速配置（推荐）

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

手动构建与安装

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

开发备选：运行 'npm run dev' 进入带热重载的开发模式。

rocket_launch 快速开始

运行一次引导配置，然后开始聊天。

# 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

配置通过直接编辑源代码完成。API 密钥放在 .env 中，渠道配置在 src/index.ts 中。

terminal 命令

NanoClaw 使用 npm 脚本处理所有工作流。

forum 渠道

WhatsApp 是内置渠道（通过 Baileys 库）。其他渠道——Telegram、Discord、Slack——可通过 Claude Code 技能添加 (/add-telegram, /add-discord, /add-slack)。每个群组拥有独立的隔离容器和 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

提示：在 Claude Code 中运行 /add-telegram 或 /add-discord 添加更多渠道。技能会直接修改你 fork 的源代码。

build 工具

工具是代理在对话中可以调用的能力。所有内置工具默认在沙箱中运行，作用域限定在工作区内。

# 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 记忆系统

NanoClaw 使用 SQLite (better-sqlite3) 进行持久化存储——消息、群组、会话和定时任务。每个群组还有独立的 CLAUDE.md 文件用于群组级记忆，挂载到其容器中。

# 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 配置

NanoClaw 不使用配置文件。要修改，告诉 Claude Code 你想要什么。代码库足够小，Claude 可以安全地修改它。API 密钥放在 .env 中，其他一切都在源代码中。

# 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 AI 供应商

NanoClaw 完全基于 Anthropic Claude Agent SDK 运行。Claude Code 在每个容器内运行，提供所有 AI 能力。

NanoClaw 设计上仅支持单一供应商。Claude Agent SDK 内部处理模型选择。在 .env 中设置 ANTHROPIC_API_KEY 或通过 Claude Code OAuth 认证。

key 环境变量

在本地 .env 文件中配置的环境变量。密钥按需读取，绝不加载到 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 安全

代理运行在容器中，而非应用层权限检查之后。它们只能访问明确挂载的目录。

# 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 架构

单 Node.js 进程。代理在隔离的 Linux 容器中执行，具备文件系统隔离。群组级消息队列带并发控制。通过文件系统进行 IPC。

code 开发

标准 TypeScript/Node.js 工作流。运行 'npm run dev' 进入带热重载的开发模式。

# 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 文档中心

如需深入文档，请参阅官方仓库中的 docs 目录。

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