volcengine/OpenViking

OpenViking 是面向 AI Agent 的上下文数据库，可自托管，也有托管服务。它把 Agent 的知识、长期记忆和技能放进一个 viking:// 虚拟文件系统，而不是藏在不可见的向量库里，因此 Agent 可以用 ls、tree、read、write、grep 这类文件操作访问，人也能打开目录检查和编辑 Agent 记住的内容。它适合需要持久、可分区上下文，并且想看清存储内容的 Agent 构建者。

工作方式

目录按少量上下文类型组织：资源（文档、仓库、网页）、按用户保存的记忆与技能，以及 peer 目录 Context types。两个机制决定日常使用体验。其一，经过语义处理的目录带有生成摘要，分为 L0 一句话摘要、L1 概览、L2 按需读取的完整内容，Agent 可以先判断相关性再加载原文 Context layers。其二，检索可以限定在某个子树内，而不是扫描扁平索引，从而保留项目或记忆的上下文 Retrieval。

一个具体流程是：先启动服务，用 ov CLI 导入仓库（ov add-resource），轮询索引任务状态，再用 ov ls/ov tree 浏览、用 ov find 或目录范围的 ov grep 查询 CLI setup。提交会话会把对话归档，并抽取成可检查的 Markdown 记忆 Sessions；启用 VikingBot 后，ov compile 可把素材组织成 wiki、知识图谱或报告 Context compilation。

运行方式与条件

• 自托管：需要 uv、Python 3.10+，以及提供 embedding 模型和 VLM 的模型服务商；初始化向导会写入 ~/.openviking/ov.conf，支持包括本地 Ollama 在内的多家服务商，服务在前台运行 configuration guide。
• 托管服务：由火山引擎运行同一服务，文档称前 50 个文件免费；连接时需要服务地址和在控制台创建的 API Key product page。
• Agent 记忆插件：安装器要求 macOS 或 Linux、Node.js 18+、curl，且不需要 sudo；Windows 用户被指向桌面应用（macOS 与 Windows x64，beta）README。集成覆盖 Claude Code、Codex、Cursor、TRAE、OpenCode、MCP 客户端以及框架包。

需要注意的限制

自托管时，在把服务暴露到 localhost 之外前必须配置认证；服务支持账户与用户隔离，资源 ACL 为可选 README。安装记忆插件时要使用用户 key，而不是无法读写记忆的 root key。记忆在后台处理，所以刚说过的偏好可能不会马上被召回。

作者报告了 0.3.22 在 LoCoMo 用户记忆和 tau2-bench Agent 任务上的评测，使用 Doubao 2.0 Pro 和 Doubao embedding 模型：各 Agent 集成在 LoCoMo 上达到 80–83% 准确率，而原生记忆为 24–57%，同时 token 和延迟下降 benchmark report。这些是作者在特定模型和任务下报告的结果，不是普遍保证。

许可证按组件区分：主项目为 AGPLv3，CLI crate 和示例为 Apache 2.0，框架适配器各有自己的许可证。README 还声明禁止整体重写后再开源，并且把项目代码全部或大部分翻译成另一种编程语言需要火山引擎事先书面授权 LICENSE。