Mnemon 영구 메모리 추가
NanoClaw 에이전트 컨테이너에 mnemon 그래프 메모리를 설치해 세션을 넘어 맥락을 기억하게 만드는 스킬.
개발·코딩고급★ 30,471⑂ 12,865AI 점수 7/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
NanoClaw 에이전트 컨테이너 이미지에 mnemon 바이너리를 설치하고, 컨테이너가 시작될 때마다 mnemon setup이 Claude Code 훅을 등록하도록 배선합니다. 그 결과 에이전트는 답변 전에 관련된 과거 기억을 먼저 불러오고, 각 턴이 끝나면 새로 얻은 인사이트를 저장합니다.
구체적으로 다음 작업을 순서대로 안내합니다.
container/Dockerfile에 mnemon 설치 레이어와MNEMON_DATA_DIR환경변수 추가container/entrypoint.sh에mnemon setup --target claude-code호출 삽입(출력은 stderr로 보내 JSON 핸드셰이크를 방해하지 않음)- Dockerfile/엔트리포인트 배선이 사라지지 않도록 지키는 구조 테스트 2개 복사 및 vitest 실행
- 이미지 재빌드, 서비스 재시작, 훅 등록 여부 검증, 기억 저장 경로 확인
메모리는 에이전트 그룹별 .claude/ 마운트에 기록되므로 컨테이너를 재시작해도 유지됩니다.
이런 분께 추천
- NanoClaw로 상시 구동되는 에이전트를 운영하며 대화 맥락이 매번 초기화되는 게 불편한 분
- 기본 Claude provider(
container.json에 provider가 없거나claude)를 쓰는 에이전트 그룹 관리자 - Docker 이미지 수정, systemd/launchd 재시작, 컨테이너 로그 확인에 익숙한 중급 이상 사용자
활용 예시
- 적용 전 사전 점검:
grep -H '"provider"' groups/*/container.json으로 각 그룹의 provider를 확인해, opencode 등 다른 provider를 쓰는 그룹은 훅이 동작하지 않으니 제외합니다. - 최신 버전으로 설치: GitHub 릴리스 API로 최신 태그(예:
v0.1.1)를 확인한 뒤 Dockerfile의MNEMON_VERSION에 넣고./container/build.sh로 재빌드,docker run --rm --entrypoint mnemon nanoclaw-agent:latest --version으로 스모크 테스트. - 기억 회상 검증: 에이전트와 한 번 대화한 뒤 새 세션을 열고 이전 대화 내용을 언급합니다. 다시 설명하지 않아도 mnemon이 관련 맥락을 자동으로 끌어오면 성공입니다. 초기화가 필요하면 호스트 마운트 경로의
mnemon/폴더를 삭제하면 됩니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-mnemon 폴더를 내 ~/.claude/skills/add-mnemon/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw && mkdir -p ~/.claude/skills && cp -r /tmp/nanoclaw/.claude/skills/add-mnemon ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 NanoClaw 프로젝트를 이미 쓰고 있는지 확인합니다(이 스킬은
container/Dockerfile,container/entrypoint.sh가 있는 저장소를 전제로 합니다). - 스킬을 받아옵니다:
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw - 스킬 폴더를 개인 스킬 디렉터리로 복사합니다:
mkdir -p ~/.claude/skills && cp -r /tmp/nanoclaw/.claude/skills/add-mnemon ~/.claude/skills/- 이미 NanoClaw 저장소에서 작업 중이라면 별도 복사 없이
.claude/skills/add-mnemon이 그대로 인식됩니다.
- 이미 NanoClaw 저장소에서 작업 중이라면 별도 복사 없이
- Claude Code를 NanoClaw 프로젝트 루트에서 실행합니다.
- "add-mnemon 스킬로 에이전트에 영구 메모리를 붙여줘"처럼 요청하면 스킬이 사전 점검(Phase 1) → 변경 적용(Phase 2) → 검증(Phase 3) 순으로 진행합니다.
- 마지막으로 이미지 재빌드(
./container/build.sh)와 서비스 재시작(systemctl --user restart ...또는 macOS의launchctl kickstart)을 수행하고,docker logs ... | grep -i mnemon으로 훅 등록을 확인합니다.
GitHub에서 원본 보기 ↗라이선스: MIT