NanoClaw
에이전트를 각자의 컨테이너에 가둬 돌리는 개인 비서
git clone https://github.com/nanocoai/nanoclaw.git && cd nanoclaw && bash nanoclaw.sh메신저로 대화하는 개인 비서를 각 에이전트마다 별도의 리눅스 컨테이너에서 돌리는 도구입니다. 만든 사람이 기존 도구의 코드가 50만 줄에 설정 파일이 53개라 이해하지 못한 소프트웨어에 자기 삶을 열어 줄 수 없었다고 밝히면서, 같은 기능을 파일 몇 개로 읽을 수 있는 크기로 다시 만들었습니다. 허용 목록이나 페어링 코드 같은 응용 계층 통제가 아니라 파일시스템 격리로 막습니다. 슬랙과 텔레그램, 디스코드, 왓츠앱, 아이메시지에 붙고 기억과 예약 작업을 지원합니다. 설치 스크립트가 필요한 것을 깔고 첫 채널 연결까지 안내합니다.
판단
이럴 때 씁니다
- 메신저로 부리는 개인 비서를 직접 운영하고 싶을 때
- 에이전트에 개인 데이터를 열어 주되 격리는 확실히 하고 싶을 때
- 코드를 전부 읽고 고쳐 쓸 수 있는 크기의 비서가 필요할 때
이럴 땐 쓰지 마세요
- 도커가 없는 환경에서는 격리 전제가 무너집니다
- 설치 스크립트가 노드와 도커까지 깔므로 깨끗한 기계에서 시작하는 편이 낫습니다
- v1 에서 올라올 때는 별도 이전 절차를 밟아야 합니다
차별점
- 에이전트마다 별도 리눅스 컨테이너에서 돌려 파일시스템 수준으로 격리합니다.
- 코드베이스를 사람이 읽을 수 있는 크기로 유지하는 것을 목표로 삼습니다.
- 설치 스크립트가 빈 기계에서 첫 대화까지 데려다 놓습니다.
- 슬랙에서 에이전트를 새로 띄우면 각자 봇 정체성과 컨테이너, 기억을 갖습니다.
워크플로
- 01저장소를 받아 설치 스크립트를 돌립니다.
- 02필요한 런타임과 도커가 없으면 스크립트가 깝니다.
- 03모델 자격 증명을 등록합니다.
- 04에이전트 컨테이너를 빌드합니다.
- 05슬랙이나 텔레그램 같은 첫 채널을 연결하고 대화합니다.
주요 명령
| 명령 | 설명 |
|---|---|
git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2 | 저장소를 받습니다. |
bash nanoclaw.sh | 런타임 설치부터 첫 채널 연결까지 안내합니다. |
bash migrate-v2.sh | v1 설치본에서 상태를 옮겨 옵니다. |
함정
설치 전에 확인하세요
- 이전 스크립트를 코딩 세션 안에서 돌리지 말라고 문서가 명시합니다. 대화형 입력과 실제 셸 입출력이 필요합니다.
- 설치 중 단계가 실패하면 코딩 에이전트를 자동으로 불러 진단하고 이어서 진행합니다. 편하지만 무엇이 자동으로 고쳐졌는지 확인해야 합니다.
- 슬랙 경험이 에이전트마다 별도 앱을 만드는 방식으로 바뀌었습니다. 기존 단일 봇 설치는 그대로 돌아가지만 이전할지 결정을 요구합니다.
- 격리는 컨테이너에 기댑니다. 도커가 없거나 권한이 넓게 열려 있으면 설계가 가정한 경계가 사라집니다.
비교
같은 자리의 도구는 기능이 훨씬 많지만 코드가 수십만 줄이고 통제가 응용 계층 허용 목록에 기댑니다. 이쪽은 기능을 줄이는 대신 컨테이너 격리와 읽을 수 있는 코드 크기를 택했습니다. 개인 데이터를 붙이는 용도에서 이 선택은 취향이 아니라 위험 관리 문제입니다.
최근 변경
에이전트마다 슬랙 앱을 만들어 주는 새 방식이 기존 단일 봇 설치에도 열렸습니다. 기존 설치는 그대로 돌아가고 이전 여부를 사용자가 정합니다.