NanoClaw

당신만의 개인 AI 에이전트. 안전. 가벼움. 당신의 것.

NanoClaw는 컨테이너에서 안전하게 실행되며, 이해하고 필요에 맞게 커스터마이즈할 수 있도록 설계되었습니다.

GitHub 스타

왜 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개의 소스 파일.

메시지 수신
WhatsApp / Telegram
SQLite
저장 및 중복 제거
그룹 큐
그룹별 FIFO
컨테이너
Claude Agent SDK
응답
스트리밍 반환

단일 프로세스

하나의 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가 모든 것을 처리합니다: 의존성, 인증, 컨테이너 설정, 서비스 구성.

요구 사항

macOS 또는 Linux Node.js 20+ Claude Code Apple Container(macOS) 또는 Docker

뉴스

자주 묻는 질문

NanoClaw는 OpenClaw와 어떻게 다른가요?

NanoClaw(Nano Claw로도 알려진)는 근본적으로 다른 접근 방식을 취합니다. OpenClaw가 수천 개의 소스 파일과 수십 개의 의존성을 가진 대규모 프레임워크인 반면, NanoClaw는 한 번에 읽고 이해할 수 있는 15개의 소스 파일로 구축된 가벼운 개인 AI 에이전트입니다. NanoClaw는 애플리케이션 수준의 권한 검사에 의존하는 대신 OS 수준의 컨테이너 격리(Docker 또는 Apple Container)를 사용하여 모든 에이전트 세션을 샌드박스합니다. 완전히 감사하고 커스터마이즈할 수 있는 안전하고 최소한의 OpenClaw 대안을 찾고 있다면, NanoClaw가 바로 그것을 위해 설계되었습니다.

NanoClaw는 안전한가요?

보안은 핵심 설계 원칙입니다. 모든 에이전트 세션은 자체 파일 시스템, IPC 네임스페이스, 프로세스 공간을 가진 격리된 Linux 컨테이너 내에서 실행됩니다. 에이전트는 명시적으로 마운트된 디렉토리에만 접근할 수 있으며, 시스템에 대한 암묵적 접근은 없습니다. 전체 코드베이스가 15개 파일에 걸쳐 약 3,900줄의 코드이므로, 소프트웨어가 하는 모든 것을 현실적으로 감사할 수 있습니다. 컨테이너 수준의 격리와 작고 감사 가능한 코드베이스의 조합은 NanoClaw를 AI 에이전트를 실행하는 가장 투명하고 안전한 방법 중 하나로 만듭니다.

NanoClaw는 어떤 메시징 앱을 지원하나요?

NanoClaw는 기본적으로 WhatsApp을 지원하며, 스킬 시스템을 통해 Telegram, 이메일 및 기타 채널로 확장할 수 있습니다. Telegram 추가는 /add-telegram 스킬을 실행하는 것만큼 간단하며, 전체 설정 과정을 안내합니다. 아키텍처는 메시징 채널이 모듈식이 되도록 설계되어, 각각의 구성으로 하나 또는 여러 채널을 나란히 실행할 수 있습니다.

어떤 컨테이너 런타임이 지원되나요?

NanoClaw는 Apple Container와 Docker를 모두 지원합니다. macOS에서 Apple Container는 Apple silicon에 최적화된 빠르고 가벼운 샌드박싱을 제공하며, Docker는 대안으로 사용할 수 있습니다. Linux에서는 Docker가 자동으로 사용됩니다. 초기 /setup 과정에서 플랫폼과 선호도에 따라 어떤 런타임을 사용할지 선택합니다.

Linux에서 NanoClaw를 실행할 수 있나요?

네. NanoClaw는 macOS와 Linux 모두에서 실행됩니다. Linux에서는 Docker가 컨테이너 런타임으로 사용되며, 설정 중에 자동으로 구성됩니다. 시스템 요구 사항은 Node.js 20 이상, Claude Code, 컨테이너 런타임(Linux에서는 Docker)입니다. /setup 스킬이 플랫폼에 맞는 모든 의존성 확인과 구성을 처리합니다.

NanoClaw를 어떻게 설정하고 구성하나요?

NanoClaw는 AI 네이티브 설정 과정을 사용합니다. 저장소를 클론하고 Claude Code를 실행한 후, /setup 스킬을 실행하면 의존성 설치, 메시징 채널 인증, 컨테이너 런타임 구성, 백그라운드 서비스 시작을 안내합니다. 수동으로 편집할 구성 파일이 없습니다. Claude Code가 전체 설정을 대화형으로 처리합니다. 지속적인 변경 사항은 원하는 것을 설명하면 Claude Code가 코드베이스에서 직접 수정합니다.

NanoClaw는 다른 AI 에이전트 프레임워크와 어떻게 비교되나요?

대부분의 AI 에이전트 프레임워크는 제품을 만드는 팀을 위해 설계되었습니다. 크고 복잡하며, 이해하는 데 상당한 투자가 필요합니다. NanoClaw는 완전히 소유하고 제어하는 개인 AI 어시스턴트를 원하는 개인을 위해 설계되었습니다. 단일 Node.js 프로세스로 실행되며, 애플리케이션 수준의 샌드박싱 대신 실제 컨테이너 격리를 사용하고, 완전히 이해할 수 있을 만큼 작습니다. Claude Agent SDK에서 실행되므로 추상화 레이어 없이 Claude의 기능에 직접 접근할 수 있습니다.

NanoClaw는 오픈 소스인가요?

네. Nano Claw는 MIT 라이선스 하에 완전히 오픈 소스입니다. 전체 코드베이스는 GitHub에서 이용할 수 있으며, 기여를 환영합니다. 프로젝트는 포크와 커스터마이즈를 장려합니다. 개인 AI 에이전트는 구성하는 일반적인 프레임워크가 아니라 정확한 필요에 맞춘 동작하는 소프트웨어여야 한다는 것이 철학입니다.