NanoClaw
당신만의 개인 AI 에이전트. 안전. 가벼움. 당신의 것.
NanoClaw는 컨테이너에서 안전하게 실행되며, 이해하고 필요에 맞게 커스터마이즈할 수 있도록 설계되었습니다.
왜 NanoClaw인가?
NanoClaw는 실제로 이해할 수 있는 코드베이스로 동일한 핵심 기능을 제공합니다.
| OpenClaw | |
|---|---|---|
| 소스 파일 | 15 | 3,680 |
| 코드 줄 수 | ~3,900 | 434,453 |
| 의존성 | <10 | 70 |
| 설정 파일 | 0 | 53 |
| 이해 시간 | 8분 | 1~2주 |
| 보안 모델 | OS 컨테이너 격리 | 애플리케이션 수준 검사 |
| 아키텍처 | 단일 프로세스 + 격리된 컨테이너 | 단일 프로세스, 공유 메모리 |
지원 기능
NanoClaw가 기본 제공하는 모든 기능, 불필요한 것은 없습니다.
메시징 앱
WhatsApp, Telegram 등. 이미 사용하고 있는 앱을 통해 스마트폰에서 NanoClaw 에이전트에게 메시지를 보내세요.
컨테이너 격리
에이전트는 Apple Container(macOS) 또는 Docker에서 실행됩니다. 명시적으로 마운트한 것만 볼 수 있습니다.
에이전트 스웜 신규
NanoClaw는 복잡한 작업에 협력하는 전문 에이전트 팀을 생성할 수 있습니다. 이를 지원하는 최초의 개인 AI입니다.
그룹별 메모리
각 그룹은 고유한 CLAUDE.md 메모리, 격리된 파일 시스템을 가지며, 자체 컨테이너 샌드박스에서 실행됩니다.
예약 작업
Claude를 실행하고 결과를 메시지로 보내는 반복 작업. 아침 브리핑, 주간 리뷰 등.
스킬 시스템
비대해지지 않고 기능을 확장하세요. 스킬을 통해 Gmail, Telegram 또는 커스텀 기능을 추가하세요.
AI 네이티브 설정
설치 마법사가 없습니다. Claude Code가 의존성, 인증, 컨테이너, 서비스 등 모든 것을 안내합니다.
웹 접근
NanoClaw는 웹을 검색하고, 콘텐츠를 가져오고, 페이지를 탐색하여 무엇이든 조사할 수 있습니다.
아키텍처
NanoClaw는 단일 Node.js 프로세스입니다. 격리된 컨테이너의 에이전트. 15개의 소스 파일.
단일 프로세스
하나의 Node.js 프로세스가 메시지를 폴링하고, 큐를 관리하고, 컨테이너를 생성하고, IPC를 처리합니다. 마이크로서비스도, 메시지 브로커도 없습니다.
그룹별 격리
각 그룹은 자체 컨테이너, 파일 시스템, IPC 네임스페이스, Claude 세션을 갖습니다. 그룹은 다른 그룹의 데이터에 접근할 수 없습니다.
동시성 제어
GroupQueue는 동시 컨테이너 수를 제한합니다(기본값: 3). 그룹별 FIFO 순서와 지수 백오프를 사용한 실패 시 재시도.
파일 시스템을 통한 IPC
컨테이너는 그룹별 디렉토리의 JSON 파일을 통해 호스트와 통신합니다. 호스트가 폴링하고, 권한을 검증하고, 실행하고, 정리합니다.
주요 파일
index.ts — 오케스트레이터 — 폴링 루프, 메시지 처리, 에이전트 호출 container-runner.ts — 격리된 마운트로 컨테이너를 생성하고 출력을 스트리밍 group-queue.ts — 동시성 제한과 재시도 백오프를 갖춘 그룹별 FIFO 큐 ipc.ts — 권한 검사를 통한 컨테이너 IPC 요청 처리 db.ts — SQLite — 메시지, 세션, 그룹, 작업, 라우터 상태 task-scheduler.ts — 크론, 인터벌, 일회성 예약 작업 실행 철학
NanoClaw의 모든 결정을 이끄는 원칙들.
이해할 수 있을 만큼 작은
NanoClaw는 하나의 프로세스, 소수의 소스 파일입니다. 전체 코드베이스를 읽고 이해할 수 있을 만큼 작습니다.
격리를 통한 보안
에이전트는 Linux 컨테이너에서 실행됩니다. 명시적으로 마운트된 것만 볼 수 있습니다. Bash는 컨테이너 내부에서 실행되기 때문에 안전합니다.
한 명의 사용자를 위해 설계
NanoClaw는 거대한 프레임워크가 아닙니다. 정확한 필요에 맞는 동작하는 소프트웨어입니다. 포크하고, Claude Code로 당신에게 맞게 만드세요.
AI 네이티브
설치 마법사 없음; Claude Code가 설정을 안내합니다. 대시보드 없음; Claude에게 물어보세요. 디버깅 도구 없음; 문제를 설명하세요.
기능보다 스킬
기여자들은 /add-telegram과 같은 Claude Code 스킬을 추가하여 설치를 변환합니다. 결과적으로 정확히 필요한 것만 하는 깔끔한 코드를 얻게 됩니다.
최고의 하네스, 최고의 모델
Claude Agent SDK에서 실행됩니다. 즉, Claude Code를 직접 실행하는 것입니다. 하네스가 중요합니다. 좋은 하네스는 똑똑한 모델에 초능력을 줍니다.
3줄로 NanoClaw 시작하기
NanoClaw를 클론하고, 디렉토리에 들어가서, 나머지는 Claude에게 맡기세요.
$ git clone https://github.com/qwibitai/nanoclaw.git
$ cd nanoclaw
$ claude 그다음 실행 /setup Claude Code가 모든 것을 처리합니다: 의존성, 인증, 컨테이너 설정, 서비스 구성.