## 项目概述

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。

## 安装与快速开始

### 安装服务器

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

### 使用 CLI

```bash
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 插件

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

## 典型使用方法

### 导入资源并搜索

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

### 集成到 Claude Code

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

### 使用 LangChain

```python
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 仓库](https://github.com/volcengine/OpenViking)
- [官方网站](https://openviking.ai/)
- [文档](https://docs.openviking.ai/)
- [博客](https://blog.openviking.ai/)
- [Live Demo](https://openviking.ai/studio)

## 信息来源和分析时间

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