向量数据库VikingDB
向量数据库VikingDB
- 文档首页
向量数据库VikingDBOpenViking Service快速接入
文档反馈
问问助手在本指南里，我们会引导您在短短几分钟内迅速完成首个 OpenViking Service 库的开通、配置工作，让您能够在我们的配置页面走完创建个人库，接入 Agent，上传您的知识、技能和记忆的全部流程。
分为以下三个步骤：
- 进入 火山引擎官网，单击页面右上角的【立即注册】。
- 完成实名认证，更多详情参考 实名认证。
- 点此链接开通 OpenViking Service 服务。
开通 OpenViking Service
在开通页面，点击【立即开通】。
创建 OpenViking Service 库
点击【创建库】，进入创建页面。
配置 OpenViking Service 库
- 在 创建库 页面填写相关参数，包括 OpenViking Service 基础信息、模型配置。
- 基本信息：填写名称、描述
- 模型配置：
说明
模型配置需要先在方舟授权完成，您可点击【前往方舟授权】完成授权步骤。
授权完成以后返回当前页面，点击【授权完成，刷新】即可进行下述操作
1. 如果您已经购买了方舟 Coding Plan，点击【从 Coding Plan 选择】，配置 VLM 和 Embedding 模型，并选择或创建方舟 API Key。
说明
已了解方舟 Coding Plan 的用户，可以访问方舟 Coding Plan 活动按需订阅套餐，参见快速开始开启 AI 编程之旅。
* VLM 模型（必选） * Embedding 模型（必选） * 方舟 API Key（必选） 2. 您也可以选择【从全部模型中选择】，配置 VLM 和 Embedding 模型，并选择或创建方舟 API Key。 * VLM 模型（必选） * Embedding 模型（必选） * 方舟 API Key（必选）
- 填写完成后单击右下角【创建库】，完成 OpenViking Service 创建流程。
前置条件：您已经在本地或者云服务器上部署了 OpenClaw，OpenClaw 支持 2026.03.07 及以上版本。
点击进入【接入 Agent】页面，选择 【 OpenClaw 插件接入】，按照界面上的步骤完成 OpenViking Service 的安装：
安装命令为：
openclaw plugins install clawhub:@openviking/openclaw-plugin && openclaw openviking setup
执行安装命令以后，按照以下提示输入信息：
🦞 OpenClaw 2026.5.7 (eeef486) — Half butler, half debugger, full crustacean. 🦣 OpenViking 插件配置向导 未找到现有配置，开始配置向导。 ── 远程模式配置 ── OpenViking 服务器地址 [http://127.0.0.1:1933]: https://api.vikingdb.cn-beijing.volces.com/openviking # 复制步骤 2 中提供的 server url API Key（可选）: xxx # 复制步骤 2 中提供的 API Key 正在检测 API Key 类型... ✓ User key 已验证 Agent Prefix（可选）: xxx # 输入你自定义的 Agent ID 正在测试连接 https://api.vikingdb.cn-beijing.volces.com/openviking... ✓ 连接成功 (version: v0.3.20) 模式: remote baseUrl: https://api.vikingdb.cn-beijing.volces.com/openviking apiKey: ZGVm...E5Mg
运行命令重启 OpenClaw：
openclaw gateway restart
重启完成以后，在页面点击【我已重启 OpenClaw】，页面右侧会出现相应的 Agent 信息，完成接入：
接下来您可以在自己的聊天频道上自由和 Agent 交互，所有的信息都会被陆续记录到 OpenViking Service 的上下文管理空间内，您可以随时在上下文管理页面查看您的对话和其他信息，并进行目录检索。
- 查看记忆：
【上下文管理】空间的左侧导航栏将所有数据清晰地划分为四个核心维度：
- User（用户的个性化记忆）：这里沉淀了 Agent 在与您日常交互中提取的画像。
memories文件夹包含实体（entities）、事件（events）、偏好（preferences），以及您的用户画像详情（profile.md）。 - Session（用户的原始会话记录）：您与 Agent 的会话将以一长串独立 ID 文件夹的形式，完整、按序地保存历史对话原始轨迹，方便随时追溯。
- Agent（Agent 的能力、工具和经验）：展开目录，可以查看到塑造该 Agent 的指令（
instructions）、技能（skills），以及它的专属记忆库（包含身份认同identity.md、行为模式patterns等）。 - Resources（Agent 可以引用的外部知识）
点击不同文件夹按层级展开，即可查看文件当中的记忆内容：
- 知识问答
【目录递归检索】支持使用 /find 接口进行语义检索（例如搜索特定实体“James”）时，可以掌控检索过程并观察底层逻辑：
- 灵活划定检索范围：您可以点击“检索范围”下拉菜单，聚焦在特定文件夹内，避免不相关信息的干扰：
- User：仅在用户的记忆（entities/preferences 等）和历史会话中检索。
- Agent：检索 Agent 的设定、技能指令和内部上下文。
- Resources：检索企业或个人上传的外部文档、图片、视频等外挂知识库。
- 按需控制返回数量：通过“返回数量”的滑动条，您可以自定义单次检索返回的 Top N 结果（如 Top 10）。
- 结果呈现：每一次检索都会返回结构化的详情展示，包含从高到低的相似度得分、层级标识、点击结果卡片可查看的具体文件信息、以及可跳转到具体文件的路径信息：
- 从上传文件到知识问答检索的快速实践：
向你的 Agent 发送链接，链接内容会自动传入 OpenViking Service 的 Resource 空间内：
在目录递归检索中，检索范围选择 【Resources】，输入 Query 如：从层级到智能讲了什么？
OpenViking Service 会返回对文章介绍最相关的检索结果：