Hermes Agent

Hermes Agent (Nous Research) 内置 OpenViking 记忆提供方。无需安装插件——把 Hermes 指向你的 OpenViking 服务即可，记忆存储、召回和抽取均原生支持。

隔离 Python 环境

Hermes 通过 HTTP 连接 OpenViking，因此无需把 OpenViking 安装到 Hermes 的 Python 环境中。请在独立的虚拟环境或容器中运行 OpenViking 服务。不要在 已有 Hermes 的环境中使用 --force-reinstall 安装或升级 OpenViking：Hermes 版本可能会固定与 OpenViking 已支持、已修复安全问题的版本不同的依赖。如果确实要将 两个应用放在同一环境中，请在同一次依赖求解中安装它们，并在启动任一服务前运行 python -m pip check。

配置

运行 Hermes 记忆配置向导：

hermes memory setup

向导会询问：

• OpenViking 服务 URL — 自托管服务器（默认 http://127.0.0.1:1933）或 OpenViking Service（火山引擎云）
• API Key — 本地开发模式留空
• 租户 account / user / peer ID — 多租户部署时使用。迁移期的旧 agent_id 配置会映射为请求的 actor peer。

配置保存在 Hermes 的 config.yaml 和 .env 文件中。

验证

hermes memory status

配置完成后，Hermes 自动使用 OpenViking 作为长期记忆——viking_remember、viking_recall 等记忆工具即刻可用。

参见

• Hermes — OpenViking memory provider 文档 — 完整配置指南
• 部署指南 — 搭建 OpenViking 服务
• 鉴权 — 远程访问的 API Key 设置