Repolode
nanocoai

nanocoai/nanoclaw

Claude Agent SDK 기반의 경량 개인 AI 비서로, 각 에이전트를 컨테이너로 격리하고 WhatsApp, Telegram, Slack, Discord 같은 메시징 앱에 연결합니다.

대체할 수 있는 제품:OpenClaw

스타
30,980
포크
12,725
열린 이슈
1,013
마지막 커밋
3시간 전

어떤 프로젝트인가요?

NanoClaw는 각 에이전트를 별도의 Linux 컨테이너에서 실행하는 개인 AI 비서입니다. WhatsApp, Telegram, Discord, Slack, Microsoft Teams, iMessage, Matrix, 이메일 등의 메시징 채널에 연결할 수 있으며, 각 에이전트는 고유한 지침과 메모리, 마운트된 파일을 유지합니다. OpenClaw보다 작고 감사하기 쉬운 대안을 지향하며, 전체 코드베이스를 읽고 직접 수정할 수 있도록 설계되었습니다.

에이전트는 Docker 컨테이너로 격리되며, 명시적으로 마운트된 디렉터리만 볼 수 있습니다. 인증 정보는 컨테이너 밖에 보관됩니다. 외부 API 호출은 인증을 주입하고 에이전트별 정책과 요청 한도를 적용하는 credential gateway를 거칩니다. 반복 예약 작업과 웹 검색 및 가져오기도 지원합니다.

기본 에이전트는 Anthropic의 Claude Agent SDK를 사용하며, OpenAI Codex, OpenCode, Ollama를 통한 로컬 모델 등 다른 제공자는 설치 가능한 skill로 사용할 수 있습니다. 채널과 제공자는 /add-<name> 명령으로 포크마다 추가하므로, 각 설치본에는 필요한 연동 기능만 포함됩니다. 설정은 스크립트로 진행하며, 단계가 실패하면 Claude Code에 처리를 넘길 수 있습니다.

핵심 기능

  • 01설치 가능한 channel skill을 통해 WhatsApp, Telegram, Discord, Slack, Teams, iMessage, Matrix, 이메일에 연결
  • 02각 에이전트는 별도의 Docker 컨테이너에서 실행되며, 명시적으로 마운트된 디렉터리만 볼 수 있음
  • 03요청 시 gateway가 인증 정보를 주입하므로 에이전트가 원본 API 키를 보유하지 않음
  • 04채널과 에이전트 간 유연한 라우팅을 지원하며, 에이전트별 메모리와 CLAUDE.md 지침 제공
  • 05채팅에서 일시 중지하거나 관리할 수 있는 반복 예약 작업
  • 06설정 파일이 없는 소규모 코드베이스로, 코드를 직접 수정해 사용자화

활용 사례

  • 전체 기기에 접근 권한을 주지 않고 메시지와 예약 브리핑을 처리하는 상시 실행 개인 비서 운영
  • 업무용과 개인용 채팅에 별도의 에이전트를 두고, 각각 고유한 메모리와 파일을 사용
  • 비서의 전체 코드를 읽고 수정하면서 에이전트 격리를 실험
  • Claude Code로 소규모 셀프 호스팅 비서의 포크를 사용자화

빠른 시작

  1. 1

    저장소를 클론합니다

    git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
  2. 2

    프로젝트 폴더로 이동합니다

    cd nanoclaw-v2
  3. 3

    설정 스크립트를 실행합니다. 이 스크립트는 종속성을 설치하고 에이전트 컨테이너를 빌드한 다음 첫 번째 채널을 페어링합니다

    bash nanoclaw.sh

사용 전 알아둘 점

  • 사용자 지정, 설정 중 오류 복구, /add-<channel> 스킬을 사용하려면 Docker와 Claude Code가 필요합니다.
  • 메시징 채널은 기본 설치에 포함되지 않으며 스킬을 사용해 별도로 추가해야 합니다.
  • 설정에는 Anthropic 자격 증명이 필요하며 macOS, Linux 또는 WSL2에서만 실행됩니다.

토픽

자주 묻는 질문

nanoclaw은(는) 무엇인가요?
Claude Agent SDK 기반의 경량 개인 AI 비서로, 각 에이전트를 컨테이너로 격리하고 WhatsApp, Telegram, Slack, Discord 같은 메시징 앱에 연결합니다. NanoClaw는 각 에이전트를 별도의 Linux 컨테이너에서 실행하는 개인 AI 비서입니다. WhatsApp, Telegram, Discord, Slack, Microsoft Teams, iMessage, Matrix, 이메일 등의 메시징 채널에 연결할 수 있으며, 각 에이전트는 고유한 지침과 메모리, 마운트된 파일을 유지합니다. OpenClaw보다 작고 감사하기 쉬운 대안을 지향하며, 전체 코드베이스를 읽고 직접 수정할 수 있도록 설계되었습니다.
nanoclaw은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
nanoclaw은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
nanoclaw은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. nanoclaw의 마지막 커밋은 2026년 10월 22일입니다.
nanoclaw은(는) 어디에 사용할 수 있나요?
전체 기기에 접근 권한을 주지 않고 메시지와 예약 브리핑을 처리하는 상시 실행 개인 비서 운영 업무용과 개인용 채팅에 별도의 에이전트를 두고, 각각 고유한 메모리와 파일을 사용 비서의 전체 코드를 읽고 수정하면서 에이전트 격리를 실험 Claude Code로 소규모 셀프 호스팅 비서의 포크를 사용자화
nanoclaw는 어떻게 설치하나요?
저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2 프로젝트 폴더로 이동합니다: cd nanoclaw-v2 설정 스크립트를 실행합니다. 이 스크립트는 종속성을 설치하고 에이전트 컨테이너를 빌드한 다음 첫 번째 채널을 페어링합니다: bash nanoclaw.sh
nanoclaw은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/nanocoai/nanoclaw

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트