NanoClaw란 무엇인가요?
NanoClaw는 단일 Node.js 프로세스와 소수의 핵심 파일만으로 구성된 초경량 개인용 Claude 어시스턴트입니다. Claude의 강력한 기능을 로컬 환경으로 가져와 WhatsApp 채팅, 명령줄 인터페이스(CLI), REST API 호출 등 다양한 방식으로 활용할 수 있습니다.
NanoClaw의 설계 철학은 "단순함이 곧 보안"입니다. 마이크로서비스, 메시지 큐, 복잡한 분산 아키텍처는 없습니다. 코드를 복제(clone)하고 명령어 하나만 실행하면, Claude Code가 의존성 설치, 인증, 컨테이너 및 서비스 설정을 자동으로 처리합니다. 전체 설정 과정은 AI-native 방식으로, Claude가 직접 모든 것을 구성해 줍니다.
왜 로컬 AI 어시스턴트가 필요한가요?
데이터 프라이버시. 코드, 비즈니스 데이터, 개인적인 대화 내용이 모두 로컬에 안전하게 보관됩니다. NanoClaw는 어떤 콘텐츠도 제3자 서버로 전송하지 않으며, 오직 사용자의 기기에서 Anthropic API를 호출할 뿐입니다.
한 번의 설정으로 어디서나. WhatsApp 통합을 통해 스마트폰에서도 Claude와 대화할 수 있습니다. 컴퓨터에서는 CLI를 사용하고, 애플리케이션에서는 REST API를 호출하세요. 하나의 어시스턴트로 다양한 접점을 활용할 수 있습니다.
완벽한 제어. MIT 오픈 소스 라이선스를 따릅니다. 자유롭게 포크(fork)하고 수정하여 자신의 워크플로우에 통합하세요. 벤더 종속(vendor lock-in) 걱정이 전혀 없습니다.
핵심 기능 요약
| 기능 | 설명 |
|---|---|
| 🔒 컨테이너 격리 | 각 에이전트가 독립된 Linux 컨테이너에서 실행되어 파일 시스템 격리 |
| 📱 WhatsApp 통합 | WhatsApp 그룹을 통해 Claude와 대화, 그룹별 독립적 컨텍스트 유지 |
| 🧠 그룹 메모리 | SQLite 기반 메시지 저장소, 그룹별 독립적인 CLAUDE.md 지원 |
| ⏰ 예약 작업 | 내장된 작업 스케줄러로 일일 보고, 알림, 데이터 수집 자동화 |
| 🚀 에이전트 클러스터링 | 다중 에이전트 협업으로 복잡한 작업 처리 및 여러 Claude 인스턴스 조율 |
| 🛠️ Claude Agent SDK | 스트리밍 에이전트 컨테이너를 통한 Claude 기능의 완전한 활용 |
빠른 시작
git clone https://github.com/gavrielc/nanoclaw.gitcd nanoclawclaude# Claude Code 내에서 다음 명령어를 입력하세요:/setupClaude Code가 모든 의존성 설치, 인증 구성, 컨테이너 설정 및 서비스 시작을 자동으로 처리합니다. 전체 과정은 5분도 채 걸리지 않습니다.
활용 사례
개발자. 로컬 코드 완성, 디버깅, 문서 생성. 독점 코드는 비공개로 유지하면서 최고 수준의 AI 보조 기능을 누리세요.
콘텐츠 크리에이터. 블로그, 이메일, 문서 작성 시 AI의 도움을 받으세요. 모든 초안과 아이디어는 사용자의 기기에 안전하게 저장됩니다.
데이터 분석가. 민감한 비즈니스 데이터를 로컬에서 분석하세요. 데이터가 인프라 외부로 유출되지 않습니다.
팀 협업. WhatsApp 그룹 모드를 사용하면 기술적 지식이 없는 팀원들도 Claude를 쉽게 활용할 수 있습니다.
학생 및 연구원. 논문 요약, 질의응답, 지식 베이스 관리 등에 활용하세요.
하드웨어 요구 사항
NanoClaw는 매우 낮은 사양에서도 원활하게 작동합니다:
- Node.js 20+
- 2 GB RAM
- macOS, Linux, Windows (WSL2), Raspberry Pi, Docker 지원
비용
NanoClaw는 MIT 오픈 소스 소프트웨어로 완전히 무료입니다. 사용자는 실제 토큰 사용량에 따른 Anthropic API 비용만 지불하면 되며, 월 구독료나 숨겨진 비용은 전혀 없습니다.