工具介绍
这是什么
OpenViking 是火山引擎(Volcengine)开源的一个面向 AI Agent 的上下文数据库。它把三类东西统一放进一个名为 viking:// 的虚拟文件系统:
- resources:项目文档、代码仓库、网页等资料;
- memories:用户偏好、历史经验等长期记忆;
- skills:如何完成某类任务的技能说明。
和常见的「文本进、向量出」黑箱式记忆不同,OpenViking 里每个目录都带有自动生成的摘要和概览,Agent 可以先看摘要判断相关性,再决定是否读取全文;人也可以直接打开目录查看、编辑 Agent 到底记住了什么。
主要功能(依据官方 README,本站未逐项实测)
- 文件系统式组织:用
ls、tree、read、write、grep、find等操作浏览上下文,每个条目都有viking://URI。 - 目录级检索:语义搜索可以限定在某个项目或某个记忆子树内,而不是在整个扁平向量池里扫。
- 分层加载 L0/L1/L2:L0 一句话摘要用于快速判断相关性,L1 概览用于规划,L2 才加载全文。
- 会话归档为文件:提交会话后,对话会被归档,并抽取为可读、可编辑、可合并的 Markdown 记忆;开启 VikingBot 后,
ov compile可把原始材料整理成 wiki、知识图谱或报告。 - CLI 与 SDK:提供
ov命令行工具,以及 Python、Go、TypeScript SDK 和 HTTP API。 - 与现有 Agent 集成:官方列出了 Claude Code、Codex、Cursor、TRAE、OpenCode、OpenClaw、Hermes、pi、DeerFlow、DSH、LangChain/LangGraph、MCP 客户端等接入方式,多数通过插件、Hooks 或 MCP 实现。
- VikingBot:基于 OpenViking 构建的 Agent 框架,通过
openviking[bot]可选依赖安装。 - 部署相关能力:支持账户与用户隔离、可选资源 ACL、认证;官方提供 Docker 镜像与 docker-compose。v0.5.5 起还提供 pgvector、MySQL、Redis 等后端选项(具体配置项以官方文档为准)。
适合谁
- 长期使用 Claude Code、Codex、Cursor 等编码 Agent,希望跨会话保留偏好和历史经验的开发者;
- 正在自研 Agent、需要一套可查看可管理的记忆/知识检索层的团队;
- 想把项目文档、内部资料和「怎么做某件事」的技能说明统一给 Agent 使用的技术团队。
不适合只想开箱即用聊天、不打算维护服务端的普通用户。
环境门槛
- 自建服务端:官方说明需要 uv、Python 3.10+,以及一个同时提供 embedding 模型和 VLM 的模型服务商。
- 安装 Agent 记忆插件:官方安装脚本要求 macOS 或 Linux、Node.js 18+、curl,且不需要 sudo;Windows 官方建议使用桌面版(Beta)。
- 多实例/生产部署:会涉及 MySQL、Redis、PostgreSQL 等外部组件与相应账号权限,具体见官方部署文档;本站未做部署验证。
- 若只浏览界面,官方提供在线 Studio,可免安装试用(可用性以官方站点为准)。
安装与使用(命令摘自官方 README,本站未在本地实测)
自建服务端:
uv tool install openviking --upgrade && openviking-server init
init 会写入 ~/.openviking/ov.conf,支持 Volcengine、OpenAI、Codex OAuth、Kimi、GLM 和本地 Ollama。服务端以前台方式运行,需保持终端开启。
用 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"
给已有编码 Agent 装记忆插件(官方脚本):
curl -fsSL https://openviking.ai/install | bash
脚本会要求选择工具和服务器(本机自建 / 火山引擎托管 / 自定义地址),若开启认证需填用户 key 而非 root key。安装后需要重启对应的 Agent;例如 Claude Code 中可用 /openviking-memory:ov 验证。Codex 首次启动会停在 Hooks need review,官方说明选择 Trust all and continue。
费用
- 开源版:README 说明开源服务端在 AGPLv3 下可自行部署,无需激活密钥。模型调用费用取决于你选择的模型服务商。
- 火山引擎托管版 OpenViking Service:官方说明前 50 个文件免费,之后的套餐、额度与价格待核查,请以火山引擎产品页与计费文档为准。
- Self-Managed 商业版:在自有云账号/VPC(BYOC)或离线环境部署,需 license key 激活,官方要求联系团队;报价待核查。
许可证与署名
- 主项目为 AGPLv3;
crates/ov_cli与examples为 Apache 2.0;examples/hermes-plugin保留 MIT;LangChain/LangGraph 适配器为 AGPLv3,Microsoft Agent Framework 适配器为 MIT;第三方组件遵循各自原许可。 - 版权归 Volcano Engine(火山引擎)及 OpenViking 贡献者所有,Copyright © 2026。
- README 额外声明:禁止将本项目整体重写后再次开源;将全部或大部分项目代码翻译为其他编程语言需事先获得火山引擎书面授权。
- 以网络服务形式对外提供修改版时,AGPLv3 对向远程用户提供对应源码有要求,商用前建议由法务确认合规边界。
- 本项目文档与代码版权不属于本站,转载或再分发请遵循上述许可证。
国内使用与限制
- 项目方为火山引擎,官方提供中文 README、中文文档站和境内(cn-beijing)托管服务,中文资料相对完整。
- 安装脚本从
openviking.ai拉取,托管版接口域名为api.vikingdb.cn-beijing.volces.com;不同网络环境下的实际可达性与速度待核查,本站未做联网实测。 - 模型服务可选 Volcengine、Kimi、GLM、本地 Ollama 等境内可用方案;选择 OpenAI、Codex OAuth 等境外服务时,需自行解决账号与网络条件。
- 桌面版目前为 Beta,且仅提供 macOS(arm64/x64)与 Windows x64 安装包。
待核查事项
- 官方 README 公布的 LoCoMo、tau2-bench 等评测成绩为项目方自测结果,本站未复现,不应视为第三方独立验证结论。
- 各 Agent 集成插件(Hooks/MCP/扩展)在实际版本下的稳定性与兼容性。
- 托管版与商业版的具体价格、配额、SLA。
- 自建部署在多人协作与生产环境下的运维成本、升级迁移影响(官方 v0.5.5 发布说明中列有多项破坏性配置变更)。
以上内容为待审核草稿,未经过本站实测。
来源与加工说明
来源:https://github.com/volcengine/OpenViking
许可证:AGPL-3.0
依据 GitHub 原始资料由 AI 整理的中文待审核草稿,未经本站实测。原始版权与许可归原作者;未声明许可不代表允许转载或再分发。
来源类型:GitHub;授权范围待核验
运行与适配
如何理解使用难度?
- 直接使用:通常打开网页或登录账号即可使用。
- 简单配置:需要填写密钥、连接服务或导入配置。
- 需要部署:需要安装依赖、配置运行环境或自行部署。
- 技术开发:需要编程、接口集成或开发调试。
格数越多,使用门槛越高;具体要求请看下方说明。
国内可用性待核验
访问来源 ↗国内使用情况与网友核验
网友核验 用户经验分享
与站长实测独立,不代表官方认证或本站已实测。
最近核验:暂无有效核验。参与人数按当前项目有效身份去重;不同核验项分别统计,不合并成用户总结果。仅统计审核通过且未过期的记录。
分项统计、有效期与样本量
| 核验项目 | 有效人数 | 成功 / 部分 / 失败 / 无法判断 | 成功率 | 最近核验 / 有效期 |
|---|---|---|---|---|
| 官方网站访问 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| GitHub 仓库访问 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| 安装与运行 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 官方服务国内连接 / MCP 连接 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 国内网络情况 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| 国内模型兼容性 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 自定义 API | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 海外服务依赖 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 海外账号要求 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 中文界面 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 客户端兼容性 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 账号及费用信息 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
成功率 = 成功 ÷(成功 + 部分成功 + 失败);无法判断不计入分母。至少 5 份可判断结果才显示成功率。账号、费用、海外依赖与语言等事实项,成功表示核查结论与资料吻合,具体观察另行统计;不表示免费或没有海外依赖。不同网络、客户端和版本的结果不能直接等同。
最近有效核验
暂无审核通过且未过期的网友核验。欢迎提交真实使用记录。
查看全部有效核验 →