使用指南
返回主页

外观

Hermes Agent 配置 ​

Hermes Agent 是 Nous Research 开发的自我改进型 AI Agent，支持桌面界面、终端和多种消息平台。这里通过 OpenAI 兼容的自定义端点连接 custom。

接入协议OpenAI Compatible / Chat Completions
打开安装说明

配置步骤

  1. 1

    打开 Hermes Agent 官方安装页完成安装；首次启动时，在供应商列表中选择“Local / custom endpoint”。

  2. 2

    在第一个输入框粘贴下方 Base URL，在第二个输入框粘贴自己的完整 API Key，再点击“Connect”。

  3. 3

    进入主界面后，在底部输入框键入一条简单消息，然后点击右侧的发送按钮。

  4. 4

    收到回复后，可以点击输入框底部的当前模型，在模型列表中选择页面复制区显示的模型名称。

复制配置

Hermes Agent 自定义端点字段

供应商: Local / custom endpoint
Base URL: 
API Key: sk-your-api-key
模型: gpt-5.6-sol（连接后在模型列表中选择）
看图操作

Hermes Agent 配置流程图

按照 4 张 Hermes Agent macOS 真实界面截图，连接 OpenAI 兼容自定义端点，发送消息验证，并按需切换 custom 模型。

截图中的供应商名称是示例，仅用于定位操作入口。实际供应商名称或 ID 统一填写 custom；地址、密钥和模型请使用本页复制区的值。

界面可能随版本变化
  1. 第 1 步

    连接自定义模型端点

    1. 1

      在供应商列表中点击“Local / custom endpoint”。

    2. 2

      第一个输入框粘贴页面复制区中的 /v1 Base URL。

    3. 3

      第二个输入框粘贴自己的完整 API Key。

    4. 4

      检查两个字段后点击“Connect”。

    首次启动 Hermes Agent 时，选择“Local / custom endpoint”。第一个输入框粘贴页面复制区提供的 /v1 Base URL，第二个输入框粘贴自己的完整 API Key，最后点击“Connect”。截图中的地址仅用于定位输入框，实际值必须以页面复制区为准；密钥已隐藏。

    自行采集Hermes Agent v0.20.6（macOS 英文界面）
  2. 第 2 步

    在主界面发送测试消息

    1. 1

      在底部输入框输入一条简单消息。

    2. 2

      点击输入框最右侧的圆形按钮发送。

    连接成功后会进入 Hermes Agent 主界面。在底部输入框键入一条简单消息，然后点击最右侧的圆形发送按钮。

    自行采集Hermes Agent v0.20.6（macOS 英文界面）
  3. 第 3 步

    确认模型能够正常回复

    1. 1

      收到正常回复，表示 Hermes Agent 已经连通 custom。

    对话区出现模型回复，就表示 Base URL、API Key 和当前模型已经正常工作。截图左下角的本机用户名已遮盖。

    自行采集Hermes Agent v0.20.6（macOS 英文界面）
  4. 第 4 步

    按需切换 custom 模型

    1. 1

      点击输入框底部显示的当前模型，展开列表。

    2. 2

      在列表中点击页面复制区当前显示的模型名称。

    需要切换模型时，点击输入框底部的当前模型，再从列表中选择页面复制区显示的模型。截图中的供应商域名和本机用户名已遮盖，模型名只用于说明界面位置。

    自行采集Hermes Agent v0.20.6（macOS 英文界面）

看不清时：点击图片可放大；配置值请复制页面中的文字，不要照着截图手工输入密钥或地址。

验证配置

使用页面复制区显示的模型发送“介绍一下你自己”；能够正常返回内容，即表示 Base URL、API Key 和模型都已正确配置。

配置示例中如果出现 sk-your-api-key 必须替换为自己的完整密钥；不要把含密钥的配置提交到 Git。

常见错误 ​

  • 返回 404：Base URL 应以 /v1 结尾，不要再追加 /chat/completions。
  • 返回 401：重新粘贴完整 API Key，不要带首尾空格。
  • 模型列表为空：确认 API 地址的 /v1/models 可访问，然后在模型菜单中点击 Refresh models。
  • 找不到页面显示的模型：确认模型已在 custom 上启用，并且 Hermes 仍使用刚配置的自定义端点。
  • 配置重启后被覆盖：检查 ~/.hermes/config.yaml，并确认没有重新选择其他供应商。
  • 服务端或容器无法连接：在 Hermes 实际运行的环境中检查 API 域名、DNS、防火墙和代理。

更多通用错误处理见常见问题。