volcengine / OpenViking

volcengine/OpenViking

open_in_new前往仓库

OpenViking 是火山引擎开源的 AI Agent 上下文数据库，将知识、记忆与技能统一为虚拟文件系统，支持目录级检索、分层摘要与跨会话记忆，并提供多智能体集成。

项目概览

项目概述

OpenViking 是火山引擎（Volcengine）开源的 AI Agent 上下文数据库，旨在统一管理 Agent 的知识、记忆与技能。它将上下文组织为 viking:// 虚拟文件系统，支持目录级检索、分层摘要（L0/L1/L2）与跨会话记忆，并提供多智能体集成。

核心功能

  • 统一上下文文件系统：将知识、记忆与技能组织为虚拟文件系统，支持 ls、tree、read、write、grep 等操作。
  • 分层摘要：自动生成目录摘要（L0）与概览（L1），帮助 Agent 快速判断相关性。
  • 目录级检索：支持按目录范围进行语义搜索，而非全局向量池。
  • 会话与记忆管理：会话提交后自动提取记忆，支持跨会话召回。
  • 多智能体集成：支持 Claude Code、Codex、Cursor、TRAE、OpenClaw、Hermes、OpenCode、LangChain 等。
  • VikingBot：基于 OpenViking 的 AI Agent 框架，支持上下文编译。
  • 桌面应用（Beta）：提供 macOS 与 Windows 的本地控制台。

适用与不适用场景

适用场景：

  • 需要为 AI Agent 提供长期记忆与上下文管理的应用。
  • 需要跨会话、跨项目知识检索的编码助手。
  • 需要统一管理知识库、记忆与技能的智能体平台。

不适用场景：

  • 对实时性要求极高且无法接受额外模型调用的场景。
  • 需要完全离线、无外部模型依赖的环境（需本地模型支持）。
  • 对 AGPL-3.0 许可证有严格限制的商业闭源项目。

技术架构与依赖

  • 语言：Python（主要）、Rust（CLI）、Go（SDK）、TypeScript（SDK）。
  • 依赖：Python 3.10+、Rust 1.91.1+、Go 1.22+、C++17 编译器、CMake 3.15+。
  • 模型提供方：支持 Volcengine、OpenAI、Codex OAuth、Kimi、GLM、本地 Ollama 等。
  • 存储：支持本地文件系统、S3、VikingDB 等。
  • 集成：MCP、HTTP API、Python/Go/TypeScript SDK。

安装与快速开始

安装服务器

uv tool install openviking --upgrade && openviking-server init

使用 CLI

ov status
ov add-resource https://github.com/volcengine/OpenViking
ov task status TASK_ID
ov ls viking://resources/
ov find "what is openviking"

安装 Agent 插件

curl -fsSL https://openviking.ai/install | bash

典型使用方法

导入资源并搜索

ov add-resource https://github.com/volcengine/OpenViking
ov find "openviking"

集成到 Claude Code

安装插件后，Claude Code 会自动召回相关记忆并捕获新内容。

使用 LangChain

from langchain_openviking import OpenVikingRetriever
retriever = OpenVikingRetriever(url="http://localhost:1933", api_key="...")
docs = retriever.invoke("What did the user decide?")

配置与部署要点

  • 配置：通过 ov.conf 配置模型提供方、存储、认证等。
  • 部署：支持 Docker、Helm、本地部署。
  • 认证：支持 API Key、OAuth、多租户隔离。
  • 安全：支持文件加密、ACL、SSRF 防护。
  • 生产部署：需配置认证，避免暴露在公网。

限制、风险与许可证

  • 许可证：主项目为 AGPL-3.0，部分组件（如 crates/ov_cli、examples）为 Apache 2.0。
  • 风险：依赖第三方模型服务，可能产生额外成本；存在安全边界要求，需遵循贡献指南中的安全规范。
  • 限制：部分功能（如桌面应用）仍为 Beta；某些集成（如 Cursor）尚未完全实现。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 README、文档、变更日志。
  • 分析时间：2026-10-02（基于最新 release v0.4.23）。