AI 에이전트를 위한 지속 메모리
기본값으로 감사 가능.
Kumiho는 컨텍스트 리셋, 모델 교체, 장기 프로젝트 상황에서도 유지되는 그래프 네이티브 에이전트 메모리를 제공합니다.
이런 경험, 있으신가요?
기억상실 문제
컨텍스트 윈도우가 리셋되면 에이전트가 모든 걸 잊어요. 매 세션이 처음부터 시작되죠.
환각 기억 문제
이전 대화를 프롬프트에 끼워넣으면 모델이 자기 요약과 사실을 혼동해요.
블랙박스 문제
에이전트가 뭔가를 "기억"하지만, 그 기억이 어디서 왔는지 추적하거나 검증할 수 없어요.
Kumiho가 세 가지 전부 해결해요. 그래프로.
Kumiho가 해주는 일
지속 회수
메모리가 그래프에 불변 리비전으로 저장돼요. 컨텍스트 리셋, 모델 교체, 프로바이더 변경에도 유지돼요.
타입 추론 엣지
DERIVED_FROM, DEPENDS_ON, REFERENCED — 모든 메모리가 어디서 왔고 뭐가 의존하는지 알아요.
Dream State 통합
비동기 백그라운드 프로세스가 메모리를 보강하고, 연결하고, 중복을 제거하고, 정리해요. 에이전트의 수면 같은 거예요.
LLM 독립
메모리는 Neo4j + Redis에 있어요, 모델 안에 있는 게 아니에요. 프로바이더를 바꿔도 히스토리를 잃지 않아요.
하루의 흐름
AI 어시스턴트가 디자인 리뷰를 진행해요. Kumiho가 대화 요약, 결정사항, 참조를 메모리 리비전으로 저장해요.
3일 뒤, 사용자가 "히어로 레이아웃 어떻게 하기로 했지?" 물어봐요. 에이전트가 전체 출처와 함께 정확한 리비전을 회수해요.
Dream State가 밤사이 실행돼요 — 디자인 결정을 프로젝트 브리프와 연결하고, 오래된 참조를 표시하고, 메타데이터를 보강해요.
2개월 뒤, 새 팀원이 에이전트에게 프로젝트 히스토리를 물어봐요. 모든 결정을 추적할 수 있고, 모든 출처가 인용돼요.
프롬프트 채워넣기 없이. 환각 없이. 그냥 회수.
연동 경로
Playground
자신의 LLM API 키로 구동되는 웹 채팅. 에이전트와 대화하며 메모리 저장 & 회수를 실시간으로 테스트하세요.
설치 순서
- 1
대시보드 사이드바에서 Playground를 여세요.
- 2
OpenAI, Anthropic, 또는 Gemini API 키를 입력하세요.
- 3
바로 대화하면서 Kumiho 메모리 저장과 회수를 테스트하세요.
# Launch Kumiho Playground
kumiho playground
# Chat with your AI agent
# Bring your own LLM API key
# Test memory store & recall in real time설치 팁
플러그인 설치 전에 Kumiho 메모리를 가장 빨리 체험하는 방법이에요.
Claude Code 플러그인
Kumiho marketplace/plugin을 설치하고 /kumiho-auth를 실행하면 Claude Code 모든 코딩 세션에서 지속 메모리를 써요.
설치 순서
- 1
plugins 저장소를 로컬에 클론한 뒤 claude 디렉터리를 marketplace source로 추가하고 kumiho-memory 플러그인을 한 번 설치하세요.
- 2
대시보드에서 Kumiho API 토큰을 발급한 뒤 Claude Code 안에서 /kumiho-auth를 실행하세요.
- 3
새 세션을 시작하고 Kumiho 메모리 도구가 자동으로 보이는지 확인하세요.
# 1. Clone the plugins repo
git clone https://github.com/KumihoIO/kumiho-plugins.git
# 2. Add the local Claude marketplace
claude plugin marketplace add ./kumiho-plugins/claude
# 3. Install the plugin
claude plugin install kumiho-memory@kumiho-claude
# 4. Authenticate inside Claude
/kumiho-auth설치 팁
Claude Code는 GitHub 저장소를 루트 기준으로만 클론해서 GitHub 하위 폴더 URL은 여기서 동작하지 않아요. 첫 실행 시 플러그인이 격리된 Python 런타임을 자동으로 준비하고, 필요하면 주변 .claude/settings*.json의 KUMIHO_* 값을 읽어요.
Claude Cowork 플러그인
같은 플러그인을 Cowork에 연결하고 한 번 인증하면 데스크톱 세션 전반에 공유 메모리와 작성자 추적이 이어져요.
설치 순서
- 1
plugins 저장소를 로컬에 클론한 뒤 claude 디렉터리를 marketplace source로 추가하고 Claude Code와 같은 Kumiho Claude plugin을 설치하세요.
- 2
Cowork 안에서 /kumiho-auth를 한 번 실행하고 Kumiho 대시보드 토큰을 붙여넣으세요.
- 3
바로 연결되지 않으면 Cowork를 재실행해 로컬 MCP 서버가 새 토큰을 반영하게 하세요.
# 1. Clone the plugins repo
git clone https://github.com/KumihoIO/kumiho-plugins.git
# 2. Add the local Claude marketplace
claude plugin marketplace add ./kumiho-plugins/claude
# 3. Install the same Kumiho Claude plugin
claude plugin install kumiho-memory@kumiho-claude
# 4. Authenticate once inside Cowork
/kumiho-auth설치 팁
marketplace add는 GitHub 하위 폴더 URL을 지원하지 않아서 저장소를 클론한 뒤 로컬 claude 경로를 써야 해요. Cowork는 로컬 Kumiho 자격 증명 캐시나 플러그인 .env.local에서 인증을 읽을 수 있고, /kumiho-auth가 가능하면 둘 다 갱신해요.
OpenClaw 플러그인
npm 플러그인을 설치하고 kumiho-setup을 실행하면 Python, 인증, openclaw.json 설정까지 마법사가 연결해줘요.
설치 순서
- 1
npm 플러그인을 설치한 뒤 kumiho-setup으로 Python 3.9+, ~/.kumiho/venv, kumiho[mcp], kumiho-memory[all]를 준비하세요.
- 2
설정 마법사에서 Kumiho 인증을 완료하고 ~/.kumiho/preferences.json을 저장한 뒤 ~/.openclaw/openclaw.json 병합을 허용하세요.
- 3
필요하면 OpenClaw를 재시작하고 openclaw kumiho stats 또는 채팅의 /memory stats로 연결을 확인하세요.
# 1. Install the Kumiho plugin for OpenClaw
openclaw plugins install @kumiho/openclaw-kumiho
# 2. Run the guided setup
npx --package=@kumiho/openclaw-kumiho kumiho-setup
# 3. Verify memory is connected
openclaw kumiho stats설치 팁
기본 추천 경로는 로컬 모드이고, API 키로 직접 HTTPS를 쓰는 Cloud mode도 지원해요.
작동 방식
메모리는 생명주기를 따라 흘러요 — 각 단계가 구조와 내구성을 더해요.
Kumiho vs. DIY 메모리 스택
솔직한 비교
| 필요한 것 | RAG + 벡터 DB | Kumiho AI Cognitive Memory |
|---|---|---|
| 대화 저장 | 청킹 + 임베딩 직접 구현 | memory_store() — 한 번의 호출 |
| 의미 기반 회수 | 벡터 유사도 (구조 없음) | 하이브리드: 전문검색 + 그래프 + 벡터 |
| 출처 추적 | 불가능 | 모든 메모리에 타입 엣지 |
| 모순 처리 | 모델이 알아서 하길 기도 | Dream State가 감지 + 해결 |
| 모델 교체 대응 | 전부 다시 임베딩 | 설계부터 LLM 독립 |
| 감사 추적 | 직접 구축 | 불변 리비전 + 타임스탬프 |