​
第 1 步：安装并准备

官方当前支持 Apple Silicon（M 系列）Mac；Intel Mac 被列为不支持。先确认已安装 Git，再在终端运行：
安装后重新打开终端。 从 ABCRelay 开始使用 准备 API Key 和当前 Key 可用的模型 ID。下文的 YOUR_ABCRELAY_API_KEY、YOUR_MODEL_ID 分别替换为这两个实际值。

​
第 2 步：配置 ABCRelay

三个系统均在安装 Hermes 的终端运行：
选择 Custom endpoint (self-hosted / VLLM / etc.)，按提示填写： 选择当前 Key 可用、支持 Chat Completions 的模型。向导默认保存到 macOS / Linux / WSL2 的 ~/.hermes/config.yaml 与 ~/.hermes/.env，或原生 Windows 的 %LOCALAPPDATA%\hermes\config.yaml 与 %LOCALAPPDATA%\hermes\.env（资源管理器路径）；自定义 HERMES_HOME 时使用该目录。 地址要带 /v1： 本页 Chat Completions 模式的 API base URL（命名 provider 的 api）填 https://www.abcrelay.com/v1，最终请求为 https://www.abcrelay.com/v1/chat/completions。不要再追加 /chat/completions；三个系统相同。

​
第 3 步：发消息验证

确认当前 provider 和模型，发送「只回复 OK，不读取文件或运行工具」。 收到回复后，到 ABCRelay 控制台 核对同一时间、Key 和模型的请求记录。

​
常见问题与详细说明

命名 provider 中，api 的填写规则随 transport 变化：Hermes 当前 Anthropic 适配器会先移除地址末尾的 /v1，再由 SDK 追加 /v1/messages；这里统一推荐根地址，避免依赖兼容处理。只在 Key 和模型已支持对应接口时切换模式；不要把表中“最终请求路径”拼进基础地址。其他客户端的同名字段可能有不同规则，见API 地址对照表。
Key 鉴权、余额或额度、网络以及通用模型错误，请先查看常见问题排查。以下列出此客户端需要额外检查的项目。
本页使用 OpenAI Chat Completions：基础地址为 https://www.abcrelay.com/v1，命名 provider 的 transport 为 chat_completions。Hermes 的命名 provider 也有其他 transport，但不能据此推断当前 ABCRelay Key 或模型支持这些协议。工具调用、图片、压缩与其他辅助模型任务可能有各自的路由和能力要求；普通聊天成功不等于这些功能均可用。
多个网关请再次运行 hermes model，让向导保存新的 provider 和凭据。默认文件路径如下；文件不存在时请新建对应文件，文件名保持不变。自定义 HERMES_HOME 时，以该目录下的 config.yaml 和 .env 为准。向导会写入 ABCRELAY_API_KEY=YOUR_ABCRELAY_API_KEY；不要把真实 Key 写入项目文件或 shell 启动文件。
当前官方文档说明：LLM_MODEL 已移除；OPENAI_BASE_URL 仍对 openai-api provider 生效，但不是本文 custom provider 的配置入口。Custom Endpoint 应通过 hermes model 或配置文件设置，不能笼统地说 OPENAI_BASE_URL 已完全失效。旧的 custom_providers 列表仍有兼容读取逻辑；新配置使用 providers 字典。本文示例使用当前字段 transport，不混入旧列表的 api_mode。
命名 provider 示例可在会话中用 /model custom:abcrelay:YOUR_MODEL_ID 切换；向导创建的名称可能不同。/model 不会录入新 Key，新增认证需用 hermes model。hermes doctor 是诊断，不是完整代理测试。聊天成功后，在测试目录单独验证只读文件工具及流式输出；图片、网页处理等任务还需检查 auxiliary 配置及实际路由。
官方一级支持 macOS Apple Silicon、Windows 10 / 11（x64 / ARM64）、Linux / WSL2（x86_64 / aarch64）；Intel Mac 明确不受支持。Linux 主要测试最新 Ubuntu / WSL2，其他发行版需满足官方平台要求。原生 Windows 可运行 CLI、TUI、工具和大部分 Dashboard 功能；Dashboard 的 /chat 嵌入终端依赖 POSIX PTY，需要 WSL2。原生安装的数据位于 $env:LOCALAPPDATA\hermes，WSL 位于其 Linux 用户的 ~/.hermes，两者配置不共用。
官方资料核对日期：2026-09-10。本页已核对 Hermes Agent 官方安装、provider 与配置文档；此次未在 ABCRelay 上运行客户端或推理测试。