Hermes Agent

1. 安装官方客户端

安装方式及系统要求请参阅Nous Research 官方安装文档。macOS / Linux 可使用官方脚本；Windows 可按官方说明选择原生安装或 WSL2；下面的命令在 WSL2 中执行：

终端复制

1curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o hermes-install.sh

2bash hermes-install.sh

下载的 hermes-install.sh 可在安装完成后删除。已安装 Hermes 的用户无需再次运行脚本。

2. 获取当前可用模型

先在控制台创建 API Key。配置工具要求 Node.js 22 或更新版本；可以从Node.js 官网安装。Windows 使用 PowerShell，macOS / Linux 使用终端。

命令会在终端提示输入 Key，输入时不显示内容。不要把 Key 发给 AI 对话，也不要放进命令参数或截图。

终端复制

1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup models

工具通过您的 Key 查询 https://api.uniroute.app/v1/models。请从返回结果选择适合当前客户端的模型，复制完整 Model ID；本文中的 MODEL_ID 需要替换为该值。模型是否可用以目录返回结果和账户权限为准；真实调用仍需验证。

3. 配置 UniRoute

终端复制

1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup configure hermes --model MODEL_ID --dry-run

先检查预览，再写入配置：

终端复制

1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup configure hermes --model MODEL_ID

工具更新用户目录下的 .hermes/config.yaml 和 .hermes/.env，添加 UniRoute 自定义供应商。支持 Anthropic Messages、OpenAI Responses 和 OpenAI Chat Completions；按所选模型使用相应协议和地址。

Gemini 原生接口不属于本配置工具的 Hermes 支持范围。不要把 /v1beta 设置成 Chat Completions 地址。

已有配置会保留无关设置；有变化的文件会先生成备份。--dry-run 不写文件；需要在隔离目录试用时，可加 --home /path/to/test-home。

4. 检查与使用

终端复制

1hermes

启动客户端后核对当前模型和 UniRoute 供应商。需要验证真实调用时，可自行发送一条简短消息，再到控制台查看调用记录；模型请求会按实际用量计费。配置和模型目录查询不会自动发起测试对话。

也可以安装UniRoute 配置 Skill，让 AI 按同样流程协助配置。

接入消息渠道与桌面界面

先完成 UniRoute 模型配置，再按Hermes 消息网关文档配置微信、飞书、Telegram 等渠道。交互向导入口是 hermes gateway setup。

桌面界面请参阅Hermes Desktop 文档，可从官方渠道下载桌面包，或在已安装的 CLI 中执行 hermes desktop。这些是 Hermes 自身的功能；频道凭据需要单独设置。