NanoClaw 시작하기
가벼운 TypeScript 코어, 하나의 설치 경로. 클론하고, claude를 실행하고, /setup을 사용하세요.
checklist 시스템 요구사항
Node.js 20+ (LTS 권장)
macOS 또는 Linux. Windows는 WSL2를 통해 작동할 수 있지만 공식 지원되지 않습니다.
512MB+ RAM. 가벼운 런타임, 무거운 컴파일 없음.
설치 시 ~50MB (node_modules). 컨테이너 이미지 추가 시 ~500MB.
필수: Apple Container (macOS) 또는 Docker (macOS/Linux). 필수: Claude Code CLI.
Anthropic API 호출에 인터넷 연결 필요. 오프라인 모드 없음.
저장소를 클론하고 Claude CLI로 시작합니다. 몇 분이면 실행됩니다.
One-Liner
Requires Claude CLI. All platforms.
git clone https://github.com/qwibitai/NanoClaw.git && cd NanoClaw && claude Step-by-Step
Clone first, then configure. More control.
git clone https://github.com/qwibitai/NanoClaw.git cd NanoClaw && npm install # Run claude and use /setup for guided configuration # Or edit .env and src/index.ts directly verified 설치 확인
아래 명령어를 실행해서 NanoClaw가 올바르게 설치되었는지 확인하세요.
node -e "console.log(require('./package.json').version)" 설치된 버전 번호가 출력되어야 합니다.
npm test 테스트 스위트(vitest)를 실행해서 의존성과 핵심 기능을 확인합니다.
claude Claude Code를 엽니다. 세션 내에서 /setup을 실행해서 안내에 따라 설정하세요.
settings 초기 설정
Claude Code가 /setup을 통해 설정을 처리합니다. 설정 내용은 다음과 같습니다.
의존성 설치
Claude Code가 npm install을 실행하고 Chromium, agent-browser, Claude Code가 사전 설치된 컨테이너 이미지(nanoclaw-agent:latest)를 빌드합니다.
인증
.env에 ANTHROPIC_API_KEY를 설정하거나, Claude Code OAuth로 인증합니다. 시크릿은 런타임에 컨테이너로 전달되며, process.env에 절대 로드되지 않습니다.
WhatsApp 연결
'npm run auth'를 실행해서 QR 코드로 페어링합니다. WhatsApp이 기본 채널입니다. 나중에 스킬(/add-telegram, /add-discord, /add-slack)로 Telegram, Discord, Slack을 추가할 수 있습니다.
에이전트 시작
'npm start'를 실행해서 NanoClaw를 시작합니다. WhatsApp에 연결하고, 메시지 폴링 루프를 시작하고, 격리된 컨테이너에서 메시지를 처리합니다.
.env — NanoClaw는 설정 파일을 사용하지 않습니다. 변경하려면 Claude Code에 원하는 것을 말하세요. 코드베이스가 충분히 작아서 Claude가 안전하게 수정할 수 있습니다.
system_update_alt NanoClaw 업그레이드
최신 기능, 연동, 보안 패치를 받으려면 NanoClaw를 최신 상태로 유지하세요.
cd NanoClaw && git pull && npm install cd NanoClaw && git pull && docker compose up --build 각 버전의 변경사항은 github.com/qwibitai/nanoclaw/releases에서 확인하세요.
build 문제 해결
자주 발생하는 문제와 해결 방법입니다.