OpenViking의 개요
OpenViking은 에이전트가 아는 모든 것을 viking:// URI 아래의 하나의 가상 파일 시스템에 담는 서버입니다. 대상은 리소스(문서, 저장소, 웹 페이지), 메모리(대화에서 추출한 선호와 경험), skills입니다. 에이전트는 ls, tree, read, grep, find로 그 안을 이동하며, 처리된 각 디렉터리에는 모델이 생성한 한 줄 요약(L0)과 개요(L1)가 붙어 있어 전체 파일(L2)을 열기 전에 요약을 읽을 수 있습니다. 검색은 하나의 평평한 벡터 풀 전체가 아니라 하위 트리로 범위를 좁힐 수 있습니다.
에이전트는 REST API와 같은 포트에서 제공되는 MCP 엔드포인트, Claude Code, Codex, Cursor, TRAE, OpenCode용 메모리 플러그인 설치 프로그램, OpenClaw, Hermes Agent, pi용 네이티브 통합, LangChain과 Microsoft Agent Framework 어댑터, Python, Go, TypeScript SDK, ov CLI를 통해 연결합니다. 세션을 커밋하면 대화가 보관되고, 추출된 메모리는 열어서 편집할 수 있는 Markdown 파일로 기록됩니다.
이 프로젝트는 ByteDance의 클라우드 사업인 Volcano Engine(Volcengine)이 만들었습니다. 메인 서버는 AGPL-3.0입니다. Volcengine은 호스팅형 OpenViking Service와, 라이선스 키로 활성화하며 분산 배포와 지원이 포함된 Self-Managed 에디션도 판매합니다.
OpenViking, 쓸 만한 가치가 있습니까?
OpenViking의 가장 좋은 발상은 메모리를 들여다볼 수 있어야 한다는 것입니다. 무작정 질의하는 벡터 저장소 대신 문서, 추출된 메모리, skills를 viking:// 경로 아래 파일로 보관하고, 각 디렉터리 맨 위에는 모델이 쓴 요약이 붙으며, 에이전트는 파일 시스템 명령으로 이를 탐색합니다. 저장소는 2026년 1월에 만들어졌고 GitHub 스타는 약 42,400개, 포크는 3,511개이며, 10월 9일의 v0.5.0부터 2026년 11월 13일의 v0.5.5까지 아홉 번 릴리스했습니다.
근거는 개발사가 직접 측정한 것입니다. README에 따르면 OpenViking을 쓴 OpenClaw, Hermes, Claude Code의 LoCoMo 긴 대화 정확도는 80~83%로, 자체 메모리를 쓸 때의 24~57%보다 높았고, 입력 토큰은 34.3~91.0% 줄었습니다. tau2-bench 작업 성공률은 retail에서 6.87포인트, airline에서 11.87포인트 올랐다고 합니다. 이 측정은 버전 0.3.22에서 Volcengine 모델인 Doubao 2.0 Pro와 Doubao-embedding-vision-251215로 진행됐으며, 독립적인 재현 결과는 공개되지 않았습니다.
모델은 직접 고를 수 있지만 무료는 아닙니다. 임베딩은 기본적으로 로컬 GGUF 모델인 bge-small-zh-v1.5를 쓰며, 설정 가이드에는 OpenAI, Azure, Gemini, Voyage, Jina, Ollama, LiteLLM을 포함해 13개 임베딩 제공업체가 나와 있습니다. 요약을 쓰고 메모리를 추출하는 비전 언어 모델에는 기본값이 없습니다. 설정 마법사는 Volcengine, OpenAI, Codex 로그인, Kimi, GLM, Ollama를 제시하며, 그 밖의 업체는 LiteLLM을 거칩니다. 문서의 상세 예제는 모두 Volcengine 베이징 엔드포인트의 Doubao 모델을 쓰므로 바꿔 적용해야 합니다. 가져오기와 커밋된 세션마다 모델 호출 비용이 듭니다.
보안 기본값은 한 대의 머신에서는 합리적이지만 그 이상에서는 손을 봐야 합니다. 서버는 127.0.0.1:1933에서 대기하며, 루트 키를 설정하지 않으면 모든 요청을 root로 취급하는 dev 모드로 실행됩니다. 이 상태로는 루프백이 아닌 주소에서 시작을 거부합니다. Docker 이미지는 0.0.0.0에 바인딩하므로 거기서는 루트 키가 필수입니다. API 키, OIDC, LDAP, 신뢰된 게이트웨이 모드가 내장되어 있고, MCP는 Claude.ai와 ChatGPT용 OAuth 2.1을 지원 합니다. 저장 데이터 암호화는 기본적으로 꺼져 있습니다. v0.5.5부터 모델 게이트웨이의 기본 프로필은 모든 도구를 노출하며, write, forget, set_acl처럼 데이터를 바꾸는 도구 여덟 개도 disabled_tools에 넣지 않는 한 포함됩니다.
대부분의 도입 여부는 라이선스가 결정합니다. AGPL-3.0은 직접 호스팅하는 수정 버전의 네트워크 사용자에게 소스 코드를 제공할 의무를 지우며, 제품 안에서 서버를 고칠 경우 이것이 문제가 됩니다. README는 또 프로젝트 전체를 다시 작성해 재공개하거나 상당 부분을 다른 언어로 옮기려면 Volcengine의 서면 허가가 필요하다고 덧붙입니다. 둘 다 Apache-2.0인 Mem0, Graphiti와 비교하면 실제 부담이며, v0.5.5 릴리스 노트에만 업그레이드와 마이그레이션 항목이 13개 있습니다.
제 역할을 하는 곳
같은 저장소에서 Claude Code와 Codex를 함께 쓰는 개발자
클라우드 계정 없이 두 에이전트가 내 선호와 지난 수정 사항을 기억하게 하고 싶다
localhost에서 openviking-server를 실행한 뒤 curl 설치 프로그램이 각 에이전트에 hooks와 MCP를 추가합니다. 메모리는 viking://user/ 아래 Markdown으로 저장되므로 잘못된 것은 편집하거나 삭제할 수 있습니다. 소프트웨어는 무료이고, 추출 모델 비용은 설정한 제공업체가 세션별로 청구합니다.
사내 어시스턴트를 만드는 직원 200명 규모 회사의 플랫폼 팀
어시스턴트에 사내 문서 대상의 범위 지정 검색과 사용자별 메모리를 주고 싶다
루트 키와 OIDC로 Docker 이미지를 배포하고, 팀별 계정과 사람별 사용자 키를 만든 뒤 어시스턴트를 REST API나 Python SDK에 연결합니다. 수정 없이 별도 서비스로 실행하는 것이 일반적인 방식이며, 호스팅하는 제품 안에서 서버를 고치면 AGPL의 소스 코드 제공 의무가 생깁니다.
이미 Volcengine을 쓰는 중 국의 SaaS 기업
데이터베이스를 하나 더 운영하지 않고 에이전트에 장기 기억을 추가하고 싶다
Volcengine의 호스팅형 OpenViking Service는 같은 서버를 베이징에서 운영합니다. 처음 50개 파일은 무료이며, 플랜과 한도는 저장소가 아니라 Volcengine 서비스 문서에 나와 있습니다.
도입 전 확인할 점
- 설정
- `uv tool install openviking --upgrade && openviking-server init`(Python 3.10+와 uv)로 임베딩 모델과 비전 언어 모델을 고릅니다. 이후 `curl -fsSL https://openviking.ai/install | bash`(macOS 또는 Linux, Node.js 18+)로 에이전트를 연결합니다. Docker 이미지 ghcr.io/volcengine/openviking과 Railway 템플릿도 공개되어 있습니다.
- 연동
- 포트 1933의 /mcp에서 Streamable HTTP 방식 MCP(stdio 프록시 포함). Claude Code, Codex, Cursor, TRAE, OpenCode, OpenClaw, Hermes Agent, pi, DeerFlow. LangChain/LangGraph와 Microsoft Agent Framework 어댑터. Python, Go, TypeScript SDK. REST API. ov CLI. /studio의 Web Studio.
- 데이터와 개인정보
- 기본은 자체 호스팅입니다. 콘텐츠는 RAGFS 파일 계층 위의 로컬 작업 공간(./data)과 벡터 인덱스에 저장되며, 공유 배포에는 pgvector, MySQL, Redis를 쓸 수 있습니다. 텍스트는 설정한 임베딩 및 비전 언어 제공업체 로 전송됩니다. 저장 데이터 암호화와 OpenTelemetry 추적은 기본적으로 꺼져 있습니다. 호스팅 서비스는 Volcengine 베이징 리전에서 운영되며, 중국 밖 호스팅은 BytePlus에서 계획되어 있습니다.
- 대규모 사용 시 비용
- AGPL 서버에는 라이선스 비용이 없습니다. 지속 비용은 모델 호출로, 가져온 디렉터리마다 요약을, 커밋한 세션마다 메모리 추출을 실행합니다. 호스팅 서비스와 Self-Managed 가격은 저장소에 공개되어 있지 않습니다.
- 제한
- 열린 issue와 pull request가 1,541개입니다. v0.5.5 노트에는 업그레이드와 마이그레이션 항목이 13개 있으며 일부는 호환되지 않는 변경입니다. 내장 벡터 저장소는 여러 프로세스를 지원하지 않으므로 공유 배포에는 원격 벡터 백엔드가 필요합니다.
좋은 점
- 메모리와 문서를 읽고 편집할 수 있는 파일로 저장
- 디렉터리 단위 검색, 전체 내용 전에 요약 확인
- MCP, hooks, SDK 세 종류, 주요 코딩 에이전트용 설치 프로그램
- 로컬 모델, OpenAI, Gemini 등 여러 제공업체와 호환
아쉬운 점
- AGPL-3.0에 더해 재작성과 이식을 제한하는 README 조항
- 예제와 벤치마크가 Volcengine의 Doubao 모델 중심
- 키를 설정하기 전까지 dev 모드에서 인증 없이 root 권한
- 마이너 릴리스 사이의 호환되지 않는 설정 변경
추천 대상
에이전트 메모리와 문서 검색을 파일 단위로 감사하고 싶고, AGPL과 빠르게 바뀌는 서버를 감수할 수 있는 팀에 맞습니다.
OpenViking 대안
OpenViking: 자주 묻는 질문
- OpenViking, 쓸 만한 가치가 있습니까?
- OpenViking은 에이전트의 메모리를 열어서 읽을 수 있는 것으로 만들지만, AGPL 라이선스, Volcengine 중심의 기본값, 잦은 호환성 깨짐 때문에 Mem0나 Graphiti보다 팀에 더 많은 것을 요구합니다. 평점은 5점 만점에 3.9점입니다.
- OpenViking의 가격은 얼마입니까?
- AGPL-3.0 오픈 소스이며 활성화 키가 필요 없습니다. 임베딩 모델과 비전 언어 모델 호출 비용은 직접 부담합니다. Volcengine의 호스팅형 OpenViking Service에는 Personal과 Enterprise 플랜이 있으며 처음 50개 파일은 무료입니다. 가격은 README에 나와 있지 않습니다. Self-Managed 에디션은 라이선스 키 방식이며 가격은 문의해야 합니다.
- OpenViking의 단점은 무엇입니까?
- AGPL-3.0에 더해 재작성과 이식을 제한하는 README 조항; 예제와 벤치마크가 Volcengine의 Doubao 모델 중심; 키를 설정하기 전까지 dev 모드에서 인증 없이 root 권한; 마이너 릴리스 사이의 호환되지 않는 설정 변경.
- OpenViking에 적합한 사람은 누구입니까?
- 에이전트 메모리와 문서 검색을 파일 단위로 감사하고 싶고, AGPL과 빠르게 바뀌는 서버를 감수할 수 있는 팀에 맞습니다.
- 팀이나 프로덕션 환경에서 OpenViking의 비용은 얼마입니까?
- AGPL 서버에는 라이선스 비용이 없습니다. 지속 비용은 모델 호출로, 가져온 디렉터리마다 요약을, 커밋한 세션마다 메모리 추출을 실행합니다. 호스팅 서비스와 Self-Managed 가격은 저장소에 공개되어 있지 않습니다.
- OpenViking에 회사 데이터를 맡겨도 안전합니까?
- 기본은 자체 호스팅입니다. 콘텐츠는 RAGFS 파일 계층 위의 로컬 작업 공간(./data)과 벡터 인덱스에 저장되며, 공유 배포에는 pgvector, MySQL, Redis를 쓸 수 있습니다. 텍스트는 설정한 임베딩 및 비전 언어 제공업체로 전송됩니다. 저장 데이터 암호화와 OpenTelemetry 추적은 기본적으로 꺼져 있습니다. 호스팅 서비스는 Volcengine 베이징 리전에서 운영되며, 중국 밖 호스팅은 BytePlus에서 계획되어 있습니다.
- OpenViking의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Mem0, Graphiti, Cognee 및 claude-mem입니다.
답변 확인일: 2026년 11월 18일.