Hermes Agent 配置 Hindsight 记忆教程：Cloud、Local External 与本地内嵌三种方式

这篇教程面向第一次接触 Hermes Agent 记忆系统的新手，目标是用 hermes memory setup 向导完成 Hindsight 配置。本文只讲向导里的三种连接方式：云端、Local External、本地内嵌。

Hindsight 是什么？

Hindsight 是一个给 AI Agent 使用的长期记忆系统。接入 Hermes Agent 后，它可以帮助 Hermes 在不同会话之间保存和召回有用信息，例如用户偏好、项目背景、环境配置、经验结论等。

启用 Hindsight 后，Hermes 通常会获得三类能力：

• hindsight_retain：保存信息到长期记忆。
• hindsight_recall：从长期记忆中检索相关信息。
• hindsight_reflect：基于已有记忆进行综合推理。

Hermes Agent 已经把 Hindsight 做成了 memory provider，所以普通用户不需要手写复杂配置，直接运行向导即可。

开始之前

先确认 Hermes Agent 可以正常运行：

hermes --version

建议再检查一次整体状态：

hermes doctor

然后进入记忆配置向导：

hermes memory setup

在 memory provider 列表里选择：

hindsight

随后 Hindsight 会让你选择连接模式。本文只讲这三个选项：

• Cloud：云端模式。
• Local External：连接已经独立运行的 Hindsight 服务。
• Local Embedded：本地内嵌模式，由 Hermes 自动拉起本机 Hindsight 服务。

方式一：Cloud 云端模式

Cloud 是最简单的方式。你不需要在本机或服务器上部署 Hindsight，只需要一个 Hindsight Cloud API Key。

适合场景

• 想最快体验 Hindsight。
• 不想维护 Docker、数据库或本地服务。
• 接受使用云端记忆服务。

需要准备

前往 Hindsight 控制台获取 API Key：

https://ui.hindsight.vectorize.io

配置步骤

hermes memory setup

依次选择：

hindsight
Cloud

向导会提示输入 API key。把 Hindsight Cloud 页面里的 key 粘贴进去即可。

接着会提示 API URL，默认是：

https://api.hindsight.vectorize.io

一般直接回车使用默认值。

方式二：Local External：连接外部 Hindsight 服务

在 hermes memory setup 里，Local External 表示连接外部已经运行的 Hindsight API。

也就是说，Hindsight 服务已经在 Hermes 外部运行好了，Hermes 只负责通过 API URL 和可选 API Key 连接它。这个服务可以用 Docker Compose 部署，也可以是裸机进程、远程服务器或其他可访问的 Hindsight 实例。

下面以 Docker Compose 为例，演示如何准备一个可供 Local External 连接的 Hindsight 服务。

适合场景

• 想把 Hindsight 独立部署在服务器上。
• 希望多个 Hermes 实例共享同一套记忆。
• 希望数据和服务都由自己掌控。
• 有 Docker Compose 使用经验。

1.用 Docker Compose 启动一个外部 Hindsight 服务

之前已经写过docker compose搭建教程，这里直引用就不在额外写教程。

2. 在 Hermes 里选择 Local External

hermes memory setup

依次选择：

hindsight
Local External

当向导提示：

Hindsight API URL [http://localhost:8888]:

如果 Docker 服务和 Hermes 在同一台机器上，直接回车即可。

如果 Hindsight 在另一台服务器上，则输入类似：

http://你的服务器IP:8888

接着会提示 API key。如果你在 Docker 的 .env 里配置了 HINDSIGHT_API_KEY，这里就输入同一个值。

如果 Hermes 自己也运行在 Docker 容器里，不要写 localhost，应该让两个容器加入同一个 Docker 网络，然后用服务名访问，例如：

http://hindsight:8888

方式三：Local Embedded 本地内嵌模式

Local Embedded 是最省心的本地化方式。你不需要自己写 Docker Compose，也不需要手动启动 Hindsight 服务。Hermes 会在本机自动拉起一个 Hindsight daemon，并在空闲一段时间后自动停止。

默认空闲超时时间是 300 秒，也就是 5 分钟。

适合场景

• 只在一台机器上使用 Hermes。
• 想本地保存记忆数据。
• 不想维护 Docker 服务。
• 愿意提供一个 LLM API Key 给 Hindsight 做记忆提取和总结。

支持的 LLM Provider

Local Embedded 需要一个 LLM 用于记忆提取和综合。向导里可以选择的提供商包括：

• OpenAI，例如 gpt-4o-mini
• Anthropic
• Gemini
• Groq
• OpenRouter，例如 qwen/qwen3.5-9b
• MiniMax
• Ollama，例如 gemma3:12b
• LM Studio
• 任意 OpenAI-compatible endpoint

如果你不知道选什么，最简单可以选 OpenAI，并填写模型：

gpt-4o-mini

如果你使用 OpenRouter，可以选 OpenRouter，并填写类似：

qwen/qwen3.5-9b

配置步骤

hermes memory setup

依次选择：

hindsight
Local Embedded

Hermes 会自动安装本地运行所需依赖。然后向导会让你选择 LLM Provider、模型名和 API Key。

示例一：使用 OpenAI：

LLM provider: openai
LLM model: gpt-4o-mini
LLM API key: 你的 OpenAI API Key

示例二：使用 OpenRouter：

LLM provider: openrouter
LLM model: qwen/qwen3.5-9b
LLM API key: 你的 OpenRouter API Key

示例三：使用 OpenAI-compatible API：

LLM provider: openai_compatible
Endpoint URL: http://你的接口地址/v1
LLM model: 你的模型名
LLM API key: 对应接口的 API Key

配置完成后，Hermes 会在首次需要使用 Hindsight 时自动启动本地服务。

配置完成后怎么生效？

无论你选择 Cloud、Local External，还是 Local Embedded，配置完成后都需要开启一个新的 Hermes 会话。

如果你在终端里使用 Hermes，退出后重新启动：

hermes

如果你通过 Telegram、Discord、Slack 等 gateway 使用 Hermes，需要重启 gateway：

hermes gateway restart

如何检查是否配置成功？

查看当前记忆配置：

hermes memory status

如果配置成功，你应该能看到当前 provider 是：

hindsight

也可以查看完整状态：

hermes status --all

如果你的外部 Hindsight 服务是用 Docker Compose 部署的，还可以检查容器日志：

docker compose logs -f hindsight

如果使用 Local Embedded，本地启动日志通常在：

~/.hermes/logs/hindsight-embed.log

三种方式怎么选？

想最快用起来：选 Cloud

Cloud 模式配置最少，只需要 API Key，适合新手快速体验。

想连接自托管服务：选 Local External

Local External 适合连接长期运行的外部 Hindsight 服务，也适合多个 Hermes 实例共享同一个 Hindsight 服务。

想本地化但不想维护外部服务：选 Local Embedded

Local Embedded 会由 Hermes 自动管理本地 Hindsight 服务，更适合单机用户和开发测试环境。

常见问题

1. 为什么 Docker Compose 部署时要选 Local External？

因为 Hermes 连接的是 Hindsight API。只要这个 API 已经在外部运行，部署方式可以是 Docker Compose、裸机进程或远程服务器。

2. Local Embedded 还需要 API Key 吗？

通常需要。Local Embedded 的数据库和检索组件可以在本地运行，但记忆提取、总结和反思通常需要一个 LLM，所以你需要填写对应 Provider 的 LLM API Key。如果使用 Ollama 或 LM Studio 这类本地模型服务，则按你的本地服务配置填写。

3. 配置完为什么没立即生效？

Hermes 的工具、记忆 provider 和部分配置是在新会话启动时加载的。配置完成后，请重新打开 Hermes；如果你使用 gateway，请重启 gateway。

4. Local External 连接 Docker Compose 服务时，Hermes 应该填 localhost 吗？

如果 Hermes 直接运行在宿主机，而 Hindsight Docker 也在同一台机器上，填 http://localhost:8888 可以。

如果 Hermes 自己也在 Docker 容器里，localhost 指的是 Hermes 容器自己，不是 Hindsight 容器。这种情况下应该使用 Docker 网络里的服务名，例如 http://hindsight:8888。

总结

Hermes Agent 配置 Hindsight 不需要手动改复杂配置。最推荐的入口就是：

hermes memory setup

三种方式可以这样选择：

• Cloud：最快、最省事，适合新手体验。
• Local External：适合连接外部自托管服务，常用于服务器部署和多实例共享。
• Local Embedded：适合单机本地化使用，Hermes 自动管理本地服务。

如果你只是想先跑起来，选 Cloud。如果你准备长期在服务器上使用，可以先用 Docker Compose 部署独立 Hindsight 服务，然后在 Hermes 里选择 Local External 连接它。如果你只在本机使用，又不想维护 Docker，选 Local Embedded。