ONEDEV

nanoclaw

AI Agent SandboxesskillTypeScript

★ 30,780주당 +64조회 4

무엇인가

NanoClaw는 개인용 AI 어시스턴트를 자기 전용 컨테이너 안에서 돌리기 위한 실행 골격과, 그 골격을 포크 단위로 확장하도록 안내하는 스킬 묶음이다. 규율하는 영역은 에이전트 격리 경계, 채널 어댑터 추가 절차, 프로바이더 교체 절차, 에이전트 그룹별 작업 공간 분리다.

어떻게 동작하나

trunk에는 레지스트리와 인프라만 두고, 채널 어댑터는 channels 브랜치, 대체 프로바이더는 providers 브랜치에 장기 유지한다. 사용자는 /add-telegram, /add-codex, /add-opencode, /add-ollama-provider 같은 슬래시 명령을 실행하고, 해당 스킬이 필요한 모듈만 포크로 복사한다. 채널과 에이전트의 연결 방식은 /manage-channels로 채널별로 지정한다. 각 에이전트 그룹은 자체 CLAUDE.md, 자체 메모리, 자체 컨테이너, 허용된 마운트만 갖는다.

무엇과 다른가

OpenClaw는 약 50만 줄 코드와 53개 설정 파일, 70개 이상 의존성을 애플리케이션 수준 allowlist·페어링 코드로 통제하고 하나의 Node 프로세스가 메모리를 공유한다. NanoClaw는 같은 핵심 기능을 한 프로세스와 소수 소스 파일로 줄이고, 권한 검사 대신 Linux 컨테이너 파일시스템 격리로 경계를 만든다. 동작 변경을 설정 파일이 아니라 코드 수정으로 처리하는 점도 구조적 차이다.

어떻게 쓰나

설치는 저장소를 클론한 뒤 nanoclaw.sh를 실행한다. 이 스크립트가 Node·pnpm·Docker를 설치하고, Anthropic 자격 증명을 OneCLI에 등록하고, 에이전트 컨테이너를 빌드하고, 첫 채널(Slack·Telegram·Discord·WhatsApp·iMessage·로컬 CLI)을 페어링한다. 실패한 단계는 Claude Code가 자동 호출되어 진단하고 이어서 진행한다. v1 사용자는 별도 체크아웃에서 migrate-v2.sh를 실행해 상태를 이전한다.

전제와 한계

Claude Code를 전제로 하며 Anthropic 공식 Claude Agent SDK를 기본 하네스로 쓴다. Codex·OpenCode·Ollama는 /add-* 스킬로 추가하는 대체 프로바이더이고 프로바이더는 에이전트 그룹 단위로 설정한다. 모니터링 대시보드나 디버깅 UI는 없고 문제는 채팅으로 서술해 Claude Code가 처리한다. 채널 어댑터는 trunk에 포함되지 않으므로 필요한 스킬을 직접 실행해야 하며, v1→v2 마이그레이션은 상태 이전까지만 수행하고 시스템 서비스 전환은 사용자가 선택한다.

유사 도구