Agent 记忆

火山引擎 OpenViking Context 为 Agent Plan 企业版 Harness 层提供 Agent 记忆服务。OpenViking Context 是基于 开源 OpenViking 内核构建的全托管云服务，是一款面向 AI Agents 的上下文数据库，以“虚拟文件系统 + 分层上下文 + 目录递归检索 + 可观测与自迭代”为核心思想，通过将 Memory、Resource、Skill 统一抽象为文件的理念，解决 AI Agent 在执行对话和长周期任务时的复杂上下文管理难题，为 AI Agent 开发者提供结构化、可追溯且低成本的上下文工程解决方案。

能力介绍#

OpenViking Context 适用于需要长程记忆、复杂知识管理和多 Agent 协作的各类 AI 应用场景，核心价值在于提供结构化、可迭代的上下文管理能力。

• Agent 长期记忆升级：作为 Agent 产品的记忆插件，为 Agent 提供记忆沉淀、检索和自进化能力，解决长周期任务中常见的遗忘和高昂成本问题。
• 全局知识资产沉淀：支持将多个代码仓库、文档库等知识源统一导入 OpenViking Context，构建可语义检索的知识库，赋能代码助手与研发场景。
• 多 Agent 协作共享：多个独立 Agent 可共享同一个 OpenViking Context 实例作为记忆与知识中枢，实现高效协同。
• 多租户安全隔离：利用多租户共享与隔离能力，为团队或企业构建安全可控的知识与记忆中心，让智能体在可控的上下文环境中执行任务。

使用限制#

• 仅支持完成了实名认证的企业用户和个人用户使用。
• 仅支持在北京地域使用 Agent Plan 企业版套餐的 AFP 额度抵扣火山引擎 OpenViking Context 资源的使用费用。
• 支持使用 Agent Plan 企业版抵扣 OpenViking Context 个人版和企业版数据库，但由于企业版数据库起步价较高，建议选择额度较高的 Agent Plan 企业版套餐。
• 如果您是子账号，首次使用时需联系主账号授权 VikingdbFullAccess 策略。
• 火山引擎官网账号未欠费（账户余额 ≥ 0）。

使用 OpenViking Context#

步骤一：订阅套餐并开通 Agent 记忆#

1. 管理员在 开通管理-Agent Plan 企业版 页面购买 Agent Plan 企业版套餐，并为成员绑定席位。套餐说明参见套餐概览。
2. 管理员需要在Harness 管理页签，开启 Agent 记忆的允许抵扣开关。
3. 席位用户在Harness区域，开启 Agent 记忆的抵扣开关。

步骤二：创建数据库#

在使用配置-配置 Harness区域，找到 Agent 记忆卡片，单击配置使用进入 OpenViking Context 页面，根据页面提示开通服务并创建数据库，创建数据库的页面左下角会展示 AFP 抵扣信息，并切换选择数据库版本。

步骤三：接入 Agent#

OpenViking Context 支持 MCP、CLI、API、SDK 接入您的自研 Agent 框架，同时对主流 Agent 框架进行生态适配。

认证说明#

Agent 接入 OpenViking 时，必须使用 OpenViking 的 API Key 作为唯一认证，并关联到对应的数据。

OpenViking API Key 可在 OpenViking Context 控制台 的用户管理页面查看与复制。

主流 Agent 集成#

1bash <(curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/claude-code-memory-plugin/setup-helper/install.sh)

1source ~/.openviking/openviking-repo/examples/claude-code-memory-plugin/setup-helper/wrapper.sh

1type claude

1openclaw plugins install clawhub:@openviking/openclaw-plugin && openclaw openviking setup

1openclaw gateway restart

1
2hermes memory setup

1hermes memory status

1bash <(curl -fsSL https://raw.githubusercontent.com/volcengine/OpenViking/main/examples/codex-memory-plugin/setup-helper/install.sh)

1
2
3
4source ~/.openviking/openviking-repo/examples/codex-memory-plugin/setup-helper/wrapper.sh

# 首次启动需执行 /hooks 进行一次安全审批
codex

1type codex

CLI 接入#

1npm i -g @openviking/cli && ov config

1ov --help

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17请先向用户询问 OpenViking API Key，并记为 OPENVIKING_API_KEY。

请在 ~/.openviking/ovcli.conf 写入以下内容：
{
  "url": "https://api.vikingdb.cn-beijing.volces.com/openviking",
  "api_key": "<OPENVIKING_API_KEY>"
}

如发现 ~/.openviking/ovcli.conf 已存在且内容冲突，请先询问用户是否备份原文件，并在得到确认后再覆盖。

请安装 OpenViking CLI：
npm i -g @openviking/cli

安装完成后，请运行：
ov --help

请探索 CLI 用法，并把 OpenViking CLI 的使用方式写入你的长期记忆。

MCP 接入#

步骤1：MCP 配置
以下为 MCP 配置示例，将 <OPENVIKING_API_KEY> 替换为 OpenViking API Key，具体参见 认证说明。

1
2
3
4
5
6
7
8
9
10{
  "mcpServers": {
    "ov-mcp-server": {
      "url": "https://api.vikingdb.cn-beijing.volces.com/openviking/mcp",
      "headers": {
        "Authorization": "Bearer <OPENVIKING_API_KEY>"
      }
    }
  }
}

步骤2：测试 MCP 工具连通性

1ov health

SDK 接入#

步骤1：安装 OpenViking

1pip install openviking --upgrade --force-reinstall

步骤2：初始化客户端

将控制台用户管理页面中展示的 API Key 复制到你的 Agent 运行环境中，建议通过环境变量或安全配置中心进行注入，而不要直接硬编码在代码里。具体参见 认证说明。

1export OPENVIKING_API_KEY="your-api-key"

步骤3：写入资源
资源写入用于把外部知识导入 OpenViking Context。SDK 可以直接接收本地文件路径、目录路径或远端 URL，并自动处理上传细节。

步骤4：写入记忆
记忆写入建议通过会话方式完成。下面示例演示如何将一条用户消息写入会话，并通过提交触发后续记忆提取。

API 接入#

如果您希望通过平台网关、工作流引擎、低代码平台直接调用接口，推荐使用 HTTP API 接入。

步骤1：写入资源
对于 HTTP 接口，本地文件不能直接作为 path 传给 /api/v1/resources，需先上传本地文件获取 temp_file_id，再调用 /api/v1/resources。

步骤2：写入记忆

通过 API 写入记忆时，同样遵循“创建会话 - 添加消息 - 提交会话”的流程。

计费说明#

• 未开启超额后付费：请求调用产生的费用使用套餐内 AFP 进行抵扣，不消耗其他资源包或账户余额。抵扣规则参见套餐内 AFP 抵扣规则。
• 开启超额后付费：在套餐周期内额度未用尽时优先抵扣套餐额度；当套餐周期内额度用尽时，无需修改任何配置信息，系统将自动切换至超额后付费模式继续使用，并产生后付费账单。具体规则与操作参见超额后付费规则和超额后付费管理。

常见问题#

• 我想保留 OpenViking 服务，仅想从 Agent Plan 企业版抵扣切换到官网付费，要如何操作？

  在 Agent Plan 企业版页面关闭抵扣后，立即进入 OpenViking Context 控制台 重新开通 OpenViking 商品即可。

• 我想保留 OpenViking 服务，仅想从官网付费切换到 Agent Plan 企业版抵扣，要如何操作？

  下单 Agent Plan 企业版套餐，并在 Agent Plan 企业版页面开启抵扣即可。

• Agent Plan 企业版额度不足且未开通超额后付费，导致服务无法使用，如何恢复？

  开启超额后付费立即恢复，通过官网出账；或升级 Agent Plan 企业版套餐扩充 AFP 额度，待下一个扣费周期扣减成功即可恢复，最长 1 小时；或升级后 oncall 客服人工恢复。

服务协议#

• OpenViking Context 专用条款
• Harness 能力说明和产品专用条款