文档中心

向量数据库VikingDB

请输入

OpenViking Context

快速接入

在本指南里，我们会引导您在短短几分钟内迅速完成首个 OpenViking Context 库的开通、配置工作，让您能够在我们的配置页面走完创建个人库，接入 Agent，上传您的知识、技能和记忆的全部流程。

开通 OpenViking Context 服务

分为以下三个步骤：

进入火山引擎官网，单击页面右上角的【立即注册】。
完成实名认证，更多详情参考实名认证。
点此链接前往开通 OpenViking Context 服务页面，点击【立即开通】。

新建 OpenViking Context 库

点击【创建库】，进入创建页面。

在 创建库 页面填写相关参数，包括 OpenViking Context 基础信息与模型凭证。

基本信息：填写库名称、库描述。
库版本：支持个人版及企业版，详细对比信息如下

添加模型凭证：

OpenViking Context 调用的 VLM 与 Embedding 模型已固定为 Doubao-Seed-2.0-lite 和 Doubao-embedding-vision（两者均不支持修改）。请从以下 3 类凭证中至少添加 1 项；添加多项时按从上到下的顺序调用，当前一个凭证发生限流或报错时，自动切换到下一个凭证。

Agent Plan：使用 Agent Plan 套餐计费。
- 未购买：前往方舟购买，购买完成后点击刷新即可识别套餐。
- 已购买：选择【+ 添加】，在弹窗中确认 API Key 后完成添加；该 Key 与 Agent Plan 同步，不支持手动修改。
Coding Plan：使用 Coding Plan 套餐计费。
- 未购买：前往方舟购买，购买完成后点击刷新即可识别套餐。
- 已购买：选择【+ 添加】，在弹窗中分别为 VLM、Embedding 选择方舟 API Key。
推理接入点：使用您自有的方舟推理接入点，无需购买套餐。在弹窗内分别为 VLM、Embedding 选择 接入点 和 方舟 API Key。无 Plan 限流，建议作为兜底渠道配置。

高级配置：

配置当前数据库对 L0 L1 内容加工的输出语言，默认输出中文

上传一篇中文文档时

选择与原始数据语言一致 & 中文的效果

选择英文的效果

填写完成后单击右下角【创建库】，以结束 OpenViking Context 创建流程。

Agent 接入（以 OpenClaw 为例）

前置条件：您已经在本地或者云服务器上部署了 OpenClaw 2026.5.2 或更新的版本。
点击进入【接入 Agent 】页面，选择【 OpenClaw 】，按照界面上的步骤完成 OpenViking Context 的安装：

安装命令为：

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

接下来您可以在自己的聊天频道上自由和 Agent 交互，所有的信息都会被陆续记录到 OpenViking Context 的上下文管理空间内，您可以随时在上下文管理页面查看您的对话和其他信息

查看上下文

控制台提供的上下文管理功能，是为开发者及运维人员提供快速总览和管理全部上下文的能力

一级目录	二级目录	三级目录
viking://user/ 用于管理用户的上下文信息	viking://user/default/ 每新增一个 user 系统自动新建一个二级目录，管理所属于当前用户的知识、用户的记忆、用户的历史对话等上下文，每个 user 目录的访问需独立鉴权。二级目录的数量与 user 数量一致	viking://user/default/memories viking://user/default/resources viking://user/default/peers viking://user/default/privacy viking://user/default/sessions viking://user/default/skills 用于存放不同类型的上下文数据
viking://resources/ 用户管理数据下公共的资源，当前数据库下所有 user 均可访问	无固定结构	无固定结构

参数、示例与排错补充

指令不具体 - 代码/命令行操作：运行前在火山引擎控制台的访问控制中创建或选择具备目标资源权限的凭证，并通过环境变量传入，禁止把密钥写进源码或提交到版本库。Python 示例保存为 .py 文件后，在已安装文中依赖的虚拟环境中执行 python <文件名>.py。

最近更新时间：2026.09.01 15:29:54

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

查看上下文 #

参数、示例与排错补充 #

查看上下文

参数、示例与排错补充