HAI Gateway

Hermes 是什么？

Hermes 是 Nous Research 推出的开源命令行 AI Agent，具备持久化记忆能力，支持任意 OpenAI 兼容端点（/v1/chat/completions）。借助 HAI Gateway，你可以用同一份 Access Token 在 Hermes 中调用 OpenAI 全系模型与国产模型（通义 QWEN / 智谱 GLM），无需为不同供应商分别管理密钥。

官方资源：

官方网站：hermes-agent.nousresearch.com
官方文档：快速开始
GitHub 仓库：NousResearch/hermes-agent

环境依赖

平台支持

Hermes 官方仅支持 Linux / macOS / WSL2 / Termux。Windows 用户需先安装 WSL2，再在 WSL2 终端内执行下方安装步骤。

依赖项	版本要求	必须	说明
bash	4.0+	是	macOS / Linux / WSL2 自带
curl	7.0+	是	用于下载安装脚本
Git	v2.23+	推荐	持久化记忆同步使用，git-scm.com

macOS / Linux 安装

步骤 1：一键安装脚本

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

步骤 2：刷新 Shell 环境

# zsh
source ~/.zshrc
 
# bash
source ~/.bashrc

步骤 3：启动配置向导

hermes model

在向导中选择 Custom endpoint (self-hosted / VLLM / etc.)，详细配置见下方配置 HAI Gateway 章节。

步骤 4：验证安装

hermes --version

安装完成

看到版本号即表示安装成功。运行 hermes 即可启动 CLI 对话。

Windows (WSL2) 安装

步骤 1：安装 WSL2

以管理员身份打开 PowerShell，运行：

wsl --install

命令会安装 WSL2 与默认的 Ubuntu 发行版，请按提示重启计算机后进入 WSL2 终端。

步骤 2：在 WSL2 内运行安装脚本

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

步骤 3：刷新 Shell 并启动配置向导

source ~/.bashrc
hermes model

为何必须使用 WSL2？

Hermes 安装脚本与运行时依赖 Linux 系统调用，在原生 Windows / PowerShell 下无法正常工作。WSL2 提供完整的 Linux 内核环境，是官方推荐方案。

配置 HAI Gateway

运行 hermes model，在 Provider 列表中选择 Custom endpoint (self-hosted / VLLM / etc.)，然后根据要调用的模型类型，在向导中依次填入 Base URL、API Key 与 Model name。

方案 A：调用 OpenAI 模型

字段	值
Base URL	`https://api.hai.network/openai/v1`
API Key	`sk-pat-您的Access Token`
Model name	`gpt-5.5-2026-04-23` / `gpt-5.4-mini-2026-03-17` / `gpt-5.4-2026-03-05` 等

方案 B：调用国产模型（通义 QWEN / 智谱 GLM）

字段	值
Base URL	`https://api.hai.network/compatible-preview/openai/v1`
API Key	`sk-pat-您的Access Token`
Model name	`qwen3-max` / `qwen3.6-plus` / `glm-4.6` / `glm-5.1` 等

提示

此通道同样兼容 OpenAI 模型，可在国产与 OpenAI 之间自由切换 model name。

config.yaml 完整示例

也可以直接编辑 ~/.hermes/config.yaml：

model:
  default: gpt-5.5-2026-04-23
  provider: custom
  base_url: https://api.hai.network/openai/v1
  api_key: sk-pat-您的Access Token
 
# 国产模型：替换 base_url / default
# base_url: https://api.hai.network/compatible-preview/openai/v1
# default:  qwen3-max

协议支持说明

Anthropic 与 Google Gemini 模型暂不支持

Hermes 仅以 OpenAI 格式（/v1/chat/completions）调用自定义端点，因此目前无法通过 HAI Gateway 的 /anthropic 与 /google 路由调用 Claude / Gemini 系列模型。

We are working on it —— 后续版本将提供原生协议透传支持。

常用命令

命令	用途
`hermes`	启动 CLI 对话
`hermes --tui`	启动现代化终端 UI
`hermes --continue`	恢复最近一次会话（持久化记忆）
`hermes model`	重新选择 / 切换模型供应商
`hermes setup`	完整配置向导（包含工具、密钥、消息样式等）
`hermes doctor`	诊断安装与配置问题

问题排查

问题	解决方案
`command not found: hermes`	重新加载 Shell（`source ~/.bashrc`），或确认 `~/.local/bin` 已加入 `PATH`
401 / API Key 无效	检查 Token 是否以 `sk-pat-` 开头，且未过期 / 未被回收
提示上下文长度不足	Hermes 要求模型至少 64K 上下文，请改用 `gpt-5.5-2026-04-23` / `qwen3-max` 等大上下文模型
WSL2 内无法访问网络	在 PowerShell 执行 `wsl --shutdown` 重启 WSL2，或检查 Windows 防火墙 / 代理设置
想修改 Base URL / Model	重新运行 `hermes model`，或直接编辑 `~/.hermes/config.yaml`

卸载与重置

完整卸载：

rm -rf ~/.hermes ~/.local/bin/hermes

仅重置配置（保留二进制）：

rm -rf ~/.hermes
hermes model   # 重新进入向导