campaign 공지사항

info 소개

NanoClaw는 Anthropic Claude Agent SDK 기반의 가벼운 완전 자율 개인 AI 어시스턴트입니다. 에이전트는 격리된 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를 실행해서 더 많은 채널을 추가하세요. 스킬이 포크의 소스 코드를 직접 수정합니다.

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