OpenViking 是什么?

OpenViking 是面向 AI Agent 的上下文数据库,把资源、长期记忆和技能放进可浏览的 viking:// 虚拟文件系统,并提供服务端、CLI、Studio、SDK 与多种 Agent 集成。主项目采用 AGPL-3.0。

⭐ 26,430 Stars 🍴 2,057 Forks Python — 作者: volcengine
来源:github.com/volcengine/OpenViking/blob/main/README.md;https://github.c… 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

v0.4.21 于 2026-09-20 发布,集中修复存储、队列、路径锁、检索和插件连接,并扩展 Hermes、MiMo、WorkBuddy 与 VikingBot 接入。

来源:github.com/volcengine/OpenViking/releases/tag/v0.4.21

核心功能

可检查的上下文文件系统

资源、记忆和技能都有 viking:// URI,可用 ls、tree、read、write、find 和 grep 浏览,不必把向量库当作不可见黑盒。

来源:github.com/volcengine/OpenViking/blob/main/README.md
服务端与多客户端

主包提供服务端和 Python 运行时;另有 Rust/npm CLI、Python/Go/TypeScript SDK、HTTP API、Studio 与 MCP/插件集成。

来源:github.com/volcengine/OpenViking/blob/main/README.md;https://github.c…
记忆与资源摄取

可导入文件、网页和代码仓库,生成目录摘要,并把会话经验写入长期记忆;远程来源由服务端访问。

来源:github.com/volcengine/OpenViking/blob/main/README.md;https://github.c…
权限与运维入口

共享资源支持 ACL、用户和 API key;v0.4.21 继续修复路径锁、队列隔离、状态归属和远程 VikingDB 行为。

来源:github.com/volcengine/OpenViking/releases/tag/v0.4.21

技术架构

OpenViking 以服务器保存虚拟文件系统、索引、任务和会话,客户端通过 CLI、SDK、HTTP 或 MCP 访问。导入资源后,后台任务解析内容并调用 embedding/VLM 生成可检索表示和目录摘要。Agent 可直接读已知 URI,也可先搜索再读取细节。自托管默认把配置写入 ~/.openviking/ov.conf,服务监听 127.0.0.1:1933。

来源:github.com/volcengine/OpenViking/blob/main/README.md;https://github.c…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 主包 Python 3.10+主包 Python 3.… openviking 0.4.21openviking 0.4… 独立 Python SDK 0.1.12 支持 Python 3.8+独立 Python SD… 可选 Node.js 的 @openviking/cli可选 Node.js 的… AGPL-3.0 主项目 可检查的上下文文件系统 服务端与多客户端 记忆与资源摄取 权限与运维入口 OpenViking 项目本体 核心功能 关键依赖

技术栈

语言Python 主运行时,Rust CLI,Python/Go/TypeScript SDK框架FastAPI/Uvicorn 服务;可配置 embedding 模型与 VLM
主包 Python 3.10+openviking 0.4.21独立 Python SDK 0.1.12 支持 Python 3.8+可选 Node.js 的 @openviking/cliAGPL-3.0 主项目
可自托管或连接火山引擎托管端点;自托管仍需模型服务或本地模型。Docker 要持久化 /app/.openviking
来源:github.com/volcengine/OpenViking/blob/main/pyproject.toml;https://git…

快速上手

用 uv tool 安装主包,运行 openviking-server init、doctor 和 server;先只绑定 127.0.0.1。配置一个 embedding 模型和一个 VLM 后,用 ov add-resource 导入无敏感内容的小文档,轮询 task status,最后用 ls、tree、find、grep 和 read 核对实际存储与召回。
来源:github.com/volcengine/OpenViking/blob/main/docs/en/getting-started/02…

使用场景

适合需要跨会话记忆、可浏览知识目录或多 Agent 共享上下文的自托管项目。它不是无需模型的普通文件管理器:导入与检索质量依赖所选 embedding/VLM,长期记忆还会保存对话衍生信息。启用自动捕获前要定义用户隔离、删除、保留和审计规则。

来源:github.com/volcengine/OpenViking/blob/main/README.md;https://github.c…

优势与局限

优势

  • viking:// 目录和 CLI 便于检查已存上下文
  • 资源、记忆和技能使用同一访问模型
  • 支持自托管、SDK、HTTP、MCP 与多种 Agent 插件
  • 活跃发布并记录迁移与回滚注意事项

局限

  • 主项目是 AGPL-3.0,网络服务和修改分发要先评估许可证义务
  • 自托管仍需要 embedding 模型和 VLM,可能产生外部 API 费用与数据传输
  • 主包与独立 SDK 的 Python 下限不同
  • 长期记忆可能保存敏感对话或错误推断,需要删除与审计流程
  • 远程 Git、网页和飞书导入会扩大服务端网络访问范围
  • v0.x 版本迭代快,升级需逐项读迁移说明
  • 本轮未部署或导入数据
来源:github.com/volcengine/OpenViking/blob/main/README.md;https://github.c…

最新版本

v0.4.21 于 2026-09-20 发布,修复存储、队列、路径锁和文件系统稳定性,增加多种 Agent 日志源与 Hermes memory provider,并调整 MCP search 参数校验、Docker 工作目录和 SDK 兼容性。

来源:github.com/volcengine/OpenViking/releases/tag/v0.4.21

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对官方 README、Quick Start、pyproject、LICENSE、Release Guide 与 v0.4.21 发布说明  |  limitations: 未安装包、未启动服务器、未配置模型、未导入资源,也未验证检索、ACL、记忆抽取、Studio 或托管服务  |  observed_output: v0.4.21 是主包最新版本;主包要求 Python 3.10+,独立 openviking-sdk 0.1.12 支持 Python 3.8+;自托管快速开始需要 embedding 模型和 VLM

来源:github.com/volcengine/OpenViking/releases/tag/v0.4.21;https://github.…

同类项目对比

与 Mem0 对比:Mem0 的开源 SDK 以 add、search、get 等记忆 API 为中心,也提供托管平台;OpenViking 把资源、记忆和技能统一成可浏览的 viking:// 目录,并带服务端、Studio 和文件式命令。应用只要简洁的用户记忆 API 时先评估 Mem0;需要目录结构、资源摄取和技能统一管理时评估 OpenViking。两者都要单独核对开源版与托管版的数据边界。

来源:github.com/mem0ai/mem0/blob/main/README.md;https://github.com/volceng…

总结评价

适合需要跨会话记忆、可浏览知识目录或多 Agent 共享上下文的自托管项目。它不是无需模型的普通文件管理器:导入与检索质量依赖所选 embedding/VLM,长期记忆还会保存对话衍生信息。启用自动捕获前要定义用户隔离、删除、保留和审计规则。采用前需要核对:主项目是 AGPL-3.0,网络服务和修改分发要先评估许可证义务。

来源:github.com/volcengine/OpenViking/blob/main/README.md;https://github.c…

常见问题

OpenViking v0.4.21 完全免费吗?

主项目源码采用 AGPL-3.0,可自行部署。embedding、VLM、托管 OpenViking 或火山引擎服务可能另有费用,应按实际提供方核对价格与数据政策。

OpenViking 会把记忆发送到云端吗?

取决于配置。服务器可以自托管,但若选择 OpenAI、火山引擎、Kimi、GLM 等 API,相关内容会进入对应服务边界;本地模型可减少外发。

为什么主包要求 Python 3.10,而 SDK 支持 3.8?

它们是不同发布物。openviking 主包包含本地服务器和完整功能,pyproject 要求 Python 3.10+;独立 openviking-sdk 0.1.12 只是连接现有服务器的轻量客户端,已把下限降到 3.8。

升级 OpenViking v0.4.21 要注意什么?

要检查 MCP search 的模式参数、Docker 工作目录、旧 Codex 模型配置和远程 VikingDB 字段长度。发布说明还给出了回滚到 v0.4.20 的建议。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件