【开源】OpenViking：字节跳动开源的 AI Agent 上下文数据库

# OpenViking：专为 AI Agent 打造的开源上下文数据库

## 项目介绍

OpenViking 是由字节跳动火山引擎开源的 AI Agent 上下文数据库（Context Database）。它的核心理念是解决 AI Agent 开发中面临的上下文管理难题——传统 RAG 系统采用碎片化的向量存储，缺乏全局视角，而 OpenViking 创新性地采用”文件系统范式”来统一管理 Agent 所需的各种上下文资源。

简单来说，OpenViking 让开发者可以像管理本地文件一样，为 AI Agent 构建一个强大的”大脑”，高效管理记忆、资源和技能。

## 为什么需要 OpenViking？

当前 AI Agent 开发面临五大挑战：

**碎片化的上下文**：记忆在代码里、资源在向量库里、技能分散在各处，难以统一管理。

**上下文需求暴涨**：Agent 长时间运行的任务会产生大量上下文，简单截断或压缩会导致信息丢失。

**检索效果差**：传统 RAG 采用扁平存储，缺乏全局视图，难以理解信息的完整上下文。

**上下文不可观测**：传统 RAG 的隐式检索链如同黑箱，出错时难以调试。

**记忆迭代能力弱**：现有记忆只是用户交互的记录，缺少 Agent 任务相关的记忆能力。

OpenViking 正是为解决这些问题而生。

## 核心特色

**文件系统管理范式**

采用熟悉的文件系统目录结构来组织 Agent 的各种上下文（记忆、资源、技能），开发者不需要学习新的复杂概念，直接用文件目录的思路管理 Agent 知识。

**三层上下文按需加载**

L0/L1/L2 三层结构，根据任务需要动态加载对应层级，大幅减少 token 消耗，降低使用成本。

**目录递归检索**

支持原生文件系统检索方式，将目录定位与语义搜索相结合，实现递归且精准的上下文获取。

**可视化检索轨迹**

支持目录检索轨迹的可视化展示，用户可以清楚地看到检索的完整路径，快速定位和解决检索质量问题。

**自动会话管理**

自动压缩对话中的内容引用、资源引用、工具调用等信息，提取长期记忆，使 Agent 越用越智能。

## 安装步骤

### Python 包安装（推荐）

“`bash
pip install openviking –upgrade –force-reinstall
“`

### Rust CLI 工具（可选）

“`bash
curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/crates/ov_cli/install.sh | bash
“`

或从源码构建：

“`bash
cargo install –git https://github.com/volcengine/OpenViking ov_cli
“`

### 环境要求

– Python 3.10 或更高版本
– Go 1.22 或更高版本（用于构建 AGFS 组件）
– C++ 编译器：GCC 9+ 或 Clang 11+（用于构建核心扩展）
– 操作系统：Linux、macOS、Windows 均支持

## 快速开始

### 1. 初始化项目

“`bash
ov_cli init my-agent
cd my-agent
“`

### 2. 配置模型

OpenViking 支持多种 VLM 和 Embedding 模型提供商：

“`bash
ov_cli config set vlm_provider openai
ov_cli config set embedding_provider openai
“`

### 3. 添加上下文

“`bash
# 添加知识文档
ov_cli add ./docs –type resource

# 添加技能
ov_cli add ./skills –type skill

# 添加记忆
ov_cli memory add “用户喜欢在晚上工作”
“`

### 4. 启动服务

“`bash
ov_cli serve
“`

服务启动后，Agent 即可通过 API 访问完整上下文。

### 与主流 Agent 框架集成

OpenViking 支持与 OpenClaw、LangChain、LlamaIndex 等主流 Agent 开发框架集成，提供统一的上下文管理能力。

## 适用场景

**复杂 Agent 开发**：在需要长时间运行、多步骤协作的复杂 Agent 场景中，OpenViking 的上下文管理能力可以显著提升 Agent 的稳定性和效果。

**知识密集型应用**：如客服机器人、研究助手等需要大量领域知识背景的应用。

**多 Agent 协作**：为多个 Agent 提供统一、可共享的上下文存储。

**企业级 AI 应用**：需要可观测、可调试的上下文管理能力的企业级项目。

## 开源协议

MIT 许可证

## 项目地址

GitHub：https://github.com/volcengine/OpenViking

官网：https://www.openviking.ai

服务支持：如有兴趣不会搭建，可以联系微信：WRYD6166，开源项目搭建10-50元。