단일 프로세스 메시지 루프 + 그룹 큐
하나의 Node 프로세스가 메시지를 폴링·라우팅하고, 그룹 단위 큐로 분리한 뒤 전역 동시성 상한으로 제어해 컨텍스트 혼선을 줄인다.
NanoClaw는 ‘끝까지 이해 가능한 크기’를 목표로 만든 개인용 AI 비서 구현이다. 에이전트를 실제 Linux 컨테이너에서 실행해 신뢰 경계를 애플리케이션 권한 체크가 아니라 OS 격리로 옮긴다.TypeScript + Node.js 단일 프로세스 오케스트레이터가 중심이며, WhatsApp을 주 채널로 대화 트리거, 예약 작업, 도구 실행, 메모리 기록을 한 루프로 묶는다. 상태와 메모리는 SQLite에 로컬 우선으로 저장되고, 그룹마다 파일시스템 컨텍스트를 분리해 문맥이 섞이지 않게 한다. 설치와 운영은 AI-native로, Claude Code가 의존성·인증·컨테이너 런타임 설정을 대화로 안내해 자가 호스팅에 적합하다.
| ✕기존 문제점 | ✓혁신적 솔루션 |
|---|---|
| 호스트에서 에이전트를 돌리면 명령·파일 접근을 기본 안전으로 만들기 어렵고, 프롬프트 실수가 곧바로 실제 환경을 건드릴 수 있다. | NanoClaw는 컨테이너를 첫 보안 경계로 둔다. Docker 또는 Apple Container로 파일시스템을 격리해 도구 실행을 샌드박스에 가둔다. |
| 범용 비서는 기능이 코어로 쌓이면서 의존성과 추상화가 비대해져 개인이 감사·커스터마이즈하기 힘들어진다. | 단일 프로세스 최소 구성으로 메시지 루프·스케줄러·메모리·컨테이너 러너를 직결하고, 확장은 skills로 분리해 코어 팽창을 막는다. |
1node --version # v20.x; docker --version # macOS/Linux; macOS는 Apple Container 선택 가능1git clone https://github.com/qwibitai/nanoclaw.git && cd nanoclaw1claude1# Claude Code 안내에 따라 setup / debug 실행, WhatsApp 연결 및 스케줄러 동작 확인| 핵심 시나리오 | 대상 고객 | 솔루션 | 최종 결과 |
|---|---|---|---|
| 보안 우선 개인 WhatsApp 비서 | 개인/인디 개발자 | WhatsApp으로 요약·자동화를 트리거하고 실행은 컨테이너로 격리 | 자가 호스팅 자동화를 더 안전한 경계에서 운영 |
| 그룹 격리형 가족/팀 도우미 | 가족·소규모 팀 | 그룹별 메모리·파일시스템 컨텍스트 분리와 정기 브리핑 | 컨텍스트 누수 없이 장기 운영 |
| 최소 구성의 감사 가능한 운영 자동화 | 반복 작업을 위임하는 엔지니어 | scheduled jobs로 운영 워크플로 구성 | 읽기 쉬운 코드와 격리로 통제된 자동 실행 |
