Hermes Agent配置指南

在 Hermes Agent 中使用平台的模型。Hermes Agent 使用 OpenAI 接口。

准备工作

• API 密钥：在控制台的 API 密钥 页新建，把下文配置里的 sk-... 换成你的密钥。
• 接入地址：https://api.gxcy.com/v1（OpenAI 接口）。
• 模型：可以调用的模型见控制台的 模型 页，下文以 deepseek-v4.1-flash 为例。

安装

Hermes Agent 支持 Linux、macOS、WSL2 与 Windows，详见 Hermes Agent 官方文档。在 Windows 上使用 WSL2 时，请先安装 WSL，再在 WSL2 中执行下面的命令。

Linux / macOS / WSL2：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows（PowerShell）：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装过程中会进入设置向导，可以在其中选择「Custom endpoint」完成配置（填写的内容见下文），也可以跳过，安装后再配置。

安装完成后重新加载终端环境（Windows 上重新打开 PowerShell 即可）：

source ~/.bashrc   # 使用 zsh 时为 source ~/.zshrc

验证安装，输出版本号即安装成功：

hermes --version

配置

Hermes Agent 用自定义服务商接入，以下三种方式任选其一。

交互设置（推荐）。 执行下面的命令，服务商选「Custom endpoint」，按提示填入接入地址、API 密钥与模型名称；询问上下文长度时留空，自动识别：

hermes model

用命令设置。 model.provider 填固定值 custom，不是自取的名称：

hermes config set model.provider custom
hermes config set model.base_url https://api.gxcy.com/v1
hermes config set model.api_key sk-...
hermes config set model.default deepseek-v4.1-flash

编辑配置文件 ~/.hermes/config.yaml（Windows 上为 %LOCALAPPDATA%\hermes\config.yaml）：

model:
  provider: custom
  base_url: https://api.gxcy.com/v1
  api_key: sk-...
  default: deepseek-v4.1-flash

配置完成后执行下面的命令检查：

hermes doctor

使用

hermes          # 经典命令行
hermes --tui    # 新版终端界面