자주 묻는 질문
NanoClaw에 관한 자주 묻는 질문과 작동 방식.
NanoClaw는 Anthropic Claude Agent SDK 기반의 가벼운 오픈소스 개인 AI 어시스턴트입니다. 에이전트는 격리된 Linux 컨테이너(macOS에서는 Apple Container, macOS/Linux에서는 Docker)에서 실행됩니다. WhatsApp 기본 내장, 다른 채널은 스킬로 추가. 영구 SQLite 메모리, 예약 작업, 웹 접근, 브라우저 자동화, 에이전트 스웜을 지원합니다.
'git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude'를 실행하고 Claude 세션에서 /setup을 사용하세요. Claude Code가 의존성, 인증, 컨테이너 설정, 서비스 설정을 처리합니다. Node.js 20+와 Claude Code가 필요합니다.
NanoClaw는 이해할 수 있을 만큼 작습니다 — 하나의 프로세스, 몇 개의 소스 파일, 마이크로서비스 없음. 비대한 프레임워크와 달리 전체 코드베이스를 읽을 수 있습니다. 에이전트는 애플리케이션 수준 권한 검사가 아닌 실제 Linux 컨테이너에서 파일시스템 격리로 실행됩니다.
NanoClaw는 Anthropic Claude Agent SDK에서만 실행됩니다. Claude Code가 각 컨테이너 내부에 전역으로 설치되어 모든 AI 상호작용을 처리합니다. SDK가 내부적으로 모델 선택을 관리합니다 — NanoClaw는 단일 프로바이더 설계입니다.
WhatsApp이 기본 채널입니다(Baileys 라이브러리, QR 코드 페어링). Telegram, Discord, Slack은 Claude Code 스킬로 추가할 수 있습니다 — /add-telegram, /add-discord, /add-slack을 실행하세요. 스킬이 포크의 소스 코드를 수정해서 깔끔한 전용 채널 지원을 추가합니다.
보안은 핵심 설계 원칙입니다. 에이전트는 Linux 컨테이너(macOS에서는 Apple Container, macOS/Linux에서는 Docker)에서 파일시스템 격리로 실행됩니다 — 애플리케이션 수준 권한 검사가 아닙니다. 시크릿은 stdin JSON으로 전달되며 process.env에 절대 로드되지 않습니다. 심링크 탈출 감지가 포함된 마운트 허용 목록. 컨테이너는 읽기 전용 프로젝트 마운트로 비루트 실행됩니다.
NanoClaw는 영구 저장을 위해 SQLite(better-sqlite3)를 사용합니다 — 메시지, 그룹, 세션, 예약 작업, 라우터 상태. 각 그룹은 컨테이너에 마운트되는 자체 CLAUDE.md 파일로 그룹별 메모리를 갖습니다. 외부 데이터베이스가 필요 없습니다.
네. NanoClaw는 macOS와 Linux에서 실행됩니다 — Node.js 20+와 Docker가 실행되는 곳이면 어디든. 가벼운 TypeScript 코어로 Raspberry Pi를 포함한 저사양 기기에서도 작동합니다. 컨테이너 런타임(Apple Container 또는 Docker)과 Anthropic API 키가 필요합니다.
에이전트 스웜은 NanoClaw가 복잡한 작업을 함께 수행하는 전문 에이전트 팀을 구성할 수 있게 합니다. NanoClaw는 Claude Code의 agent-teams 기능을 기반으로 에이전트 스웜을 지원하는 최초의 개인 AI 어시스턴트입니다.
프로젝트는 MIT 라이선스로 github.com/qwibitai/nanoclaw에서 오픈소스입니다. README에서 기여 가이드를 확인하세요. 모든 기여를 환영합니다.
내장 도구는 컨테이너 내부에서 실행되는 Claude Code가 제공합니다: 셸 명령, 파일 읽기/쓰기, 웹 검색, 웹 브라우징(Chromium), 에이전트 위임(스웜). 호스트 프로세스는 예약 작업(cron), 영구 SQLite 메모리, WhatsApp 메시징을 제공합니다. 스킬을 추가해서 기능을 확장하세요.
네. 각 에이전트 컨테이너에 Chromium이 설치되어 있고 브라우저 자동화를 위한 agent-browser가 있습니다. Claude Code가 샌드박스 컨테이너 내부에서 웹을 검색하고 페이지를 탐색해서 실시간 정보를 얻을 수 있습니다.
공식이자 유일하게 신뢰할 수 있는 저장소는 github.com/qwibitai/nanoclaw입니다. 커뮤니티 Discord는 discord.gg/VDdww8qS42입니다.
macOS와 Linux. Node.js 20+와 컨테이너 런타임이 필요합니다 — macOS에서는 Apple Container, macOS/Linux에서는 Docker. Windows는 공식 지원되지 않지만 WSL2와 Docker를 통해 작동할 수 있습니다.
NanoClaw는 Claude Agent SDK를 통해 Anthropic Claude만 사용합니다. .env 파일에 ANTHROPIC_API_KEY를 설정하거나, Claude Code OAuth로 인증하세요. 멀티 프로바이더 지원은 없습니다 — SDK가 내부적으로 모델 선택을 처리합니다.
GitHub 저장소(github.com/qwibitai/nanoclaw)의 README가 주요 문서입니다. docs/ 디렉토리에 아키텍처 스펙, 보안 모델, 디버그 체크리스트가 있습니다. 코드베이스가 충분히 작아서 Claude Code에 설명을 요청할 수 있습니다.
공식 채널: Discord(discord.gg/VDdww8qS42)와 GitHub(github.com/qwibitai/nanoclaw). README에서 모든 커뮤니티 링크를 확인하세요.