OpenViking

项目概述

OpenViking 是一款面向 AI 智能体的开源上下文数据库。它将记忆、资源、技能统一挂载到 viking:// 虚拟文件系统下，使智能体能够像开发者浏览代码一样，通过 ls、tree、find 等命令确定性地访问自身上下文，而不是面对一个黑盒式的向量存储。

核心理念

一套文件系统承载全部上下文

记忆、资源、技能各自拥有 viking:// URI，智能体可像操作文件一样定位与管理上下文。典型的目录结构如下：

viking://
├── resources/                    # 资源：项目文档、仓库、网页等
└── user/{user_id}/
    ├── memories/preferences/     # 用户偏好记忆
    ├── resources/                # 私有资源
    ├── skills/                   # 技能定义
    └── peers/                    # 协作主体

分层加载降低 Token 消耗

每条内容在写入时被预处理为三层：

• L0（摘要）：一句话概括，用于快速相关性判断。
• L1（概览）：核心信息与适用场景，用于任务规划。
• L2（详情）：原始完整数据，按需读取。

每个目录同样携带 L0/L1，因此可以在打开任何完整文件前先判断相关性。

目录式递归检索

向量检索先定位到得分最高的目录，再逐层下钻，使结果连同其周边上下文一起返回。每次查询都保留目录浏览轨迹，便于观察与调试。

会话即记忆

会话提交后，OpenViking 异步抽取用户偏好与智能体经验，形成长期记忆。

性能验证

OpenViking 0.3.22 在 LoCoMo（长对话用户记忆）和 tau2-bench（多轮智能体任务）上完成评测。

• 用户记忆（LoCoMo）：接入 OpenViking 后，三种智能体的准确率均达到 80–83%，相比原生记忆的 24–57% 显著提升，输入 Token 下降 34.3–91.0%，查询时延下降 58.45–66.10%。
• 智能体经验（tau2-bench）：经验记忆使任务成功率分别提升 +6.87 个百分点（零售）和 +11.87 个百分点（航空）。

快速上手

环境要求：Python 3.10 及以上。

pip install openviking --upgrade
openviking-server init      # 交互式向导：配置 provider、模型，写入 ov.conf
openviking-server doctor    # 校验配置
openviking-server           # 启动服务

init 支持 Volcengine、OpenAI、Codex OAuth、Kimi、GLM 以及本地 Ollama；针对 Ollama 还能自动检测并安装运行时、按硬件拉取模型。doctor 会在不启动服务的前提下检查配置文件、Python 版本、provider 连通性与磁盘空间。

安装包内置 ov 客户端 CLI，服务启动后可执行：

ov status
ov add-resource https://github.com/volcengine/OpenViking
ov ls viking://resources/
ov tree viking://resources/volcengine -L 2
ov find "what is openviking"
ov grep "openviking" --uri viking://resources/volcengine/OpenViking/docs/en

与智能体集成

OpenViking 提供与主流智能体框架的集成方案，会自动注入召回上下文并提交会话记忆，覆盖 Claude Code、Codex、OpenClaw、Hermes、Cursor、TRAE / TRAE CN / TraeCode CLI 2.0、OpenCode、pi、Agent Plugins 1.0、MCP 客户端，以及 LangChain / LangGraph。

OpenViking Helper（Beta）

桌面端控制台，目前提供 macOS 与 Windows x64 版本，核心能力包括：

• 可视化本地智能体配置：自动识别 OpenViking CLI、Claude Code、Codex、Cursor、Trae、OpenCode，并配置插件、MCP、Hook、CLI 集成。
• 会话轨迹检视：解析 Claude Code、Codex、Trae 的会话，展示召回、提示注入、MCP 调用、捕获与提交事件。
• 本地记忆与技能管理：查看本地记忆、规则文件与 SKILL.md 技能，并同步至 OpenViking。

VikingBot

基于 OpenViking 构建的 AI 智能体框架，可一键安装并启用：

pip install "openviking[bot]"
openviking-server --with-bot
ov chat

官方 Docker 镜像默认会随服务一起启动 VikingBot 与控制台 UI。

生产部署与商业版本

开源版本采用 AGPLv3，无功能阉割、无需账号或激活密钥，可自行部署到生产环境。除此之外，官方还提供两种商业形态：

• 托管 SaaS：由 Volcano Engine 运营，面向个人开发者（免费试用 50 个文件）与企业团队。
• 自托管：运行在用户自有环境中，支持在线（BYOC）与离线（完全气隙）两种部署模式，面向合规行业。

研究背景

OpenViking 开源了 VikingMem 论文中所描述的核心能力子集。该论文已被 VLDB 2026 接收，作者来自相关研究团队，arXiv 编号 2605.29640。

合作伙伴

项目欢迎开源生态合作，已确认的合作伙伴包括 deer-flow（长程 SuperAgent 框架）、NoKV（AI 原生分布式文件系统）、loopx（轻量循环工程内核）以及 Hermes Agent。

许可证

• 主项目：AGPLv3
• crates/ov_cli：Apache 2.0
• examples：Apache 2.0
• third_party：沿用各自原项目许可证