Hermes Agent API 配置：自定义端点与 Base URL

Hermes Agent 支持自定义 OpenAI-compatible endpoint。先退出当前聊天，再在终端运行下面的配置向导；聊天中的 /model 用于切换已配置的模型，不能代替首次添加端点和 Key。

Hermes 接入 Link：任务预算与分组一起检查

给 Hermes 使用独立的 Link Key，确认所选提供商的最终地址是 https://www.aifast.link/v1，并明确其使用 Chat Completions 还是 Responses。配置模板不是运行证明；应通过一条真实短任务确认生效路由。

长期任务、工具循环和定时任务可能持续消耗日额度。月卡仅覆盖指定分组；同时设置任务轮数、重试和预算上限，并核对额度用尽后的钱包扣费偏好。

查看 Link 充值与月卡规则

开始前检查

准备以下信息：

Base URL: https://www.aifast.link/v1
API Key: YOUR_LINK_API_KEY
Model: YOUR_MODEL_ID

先用 curl 验证 Key 和模型列表：

export AIFAST_LINK_API_KEY="YOUR_LINK_API_KEY"

curl https://www.aifast.link/v1/models \
  -H "Authorization: Bearer $AIFAST_LINK_API_KEY"

配置步骤

运行：

hermes model

在向导中选择自定义端点，然后依次填写：

1. API base URL：https://www.aifast.link/v1
2. API key：AI快站独立 Key
3. Model name：真实模型 ID
4. API mode：目标模型使用 Chat Completions 时选择对应模式

API mode 必须匹配目标模型实际支持的协议。当前官方向导会保存所选模式；不同版本的配置结构可能变化，以下只是核心字段示意，不要用它覆盖向导生成的完整文件。

Hermes 会把当前模型和端点保存到 ~/.hermes/config.yaml。配置完成后，检查文件中的核心字段是否一致：

model:
  default: YOUR_MODEL_ID
  provider: custom
  base_url: https://www.aifast.link/v1

不要把包含真实 Key 的配置文件提交到 Git 仓库。若使用命名的自定义 provider，优先通过 key_env 引用环境变量。

避免旧环境变量覆盖当前端点

通过向导明确保存自定义端点，检查当前 Provider 与 Base URL。不要假设旧 OPENAI_BASE_URL 或 LLM_MODEL 环境变量能覆盖当前版本的配置。

最小验证

启动 Hermes 后先发送短任务：

Reply with only: connection ok

然后检查：

1. 实际使用的是刚配置的自定义提供商，而不是旧提供商。
2. 所选模型 ID 必须在当前 Key 返回的 /v1/models 列表中。
3. 请求地址没有重复 /v1。
4. 普通对话成功后，再测试工具调用和长任务。

常见问题

配置后仍请求旧提供商

检查 ~/.hermes/config.yaml 中的 model.provider 和 model.base_url，并清理与当前设置冲突的旧环境变量。重新启动 Hermes 后再验证。

/model custom 无法自动选择模型

自动选择需要端点只返回一个模型。Link 可能开放多个模型，配置时应明确填写当前账号可用的模型 ID。

文本生成成功，但 Agent 工具失败

自定义端点必须正确处理工具调用所需的请求与响应字段。先用普通对话确认链路，再单独测试工具调用；不要把全部失败归因于模型能力。

下一步

为 Hermes 单独设置 API Key、用量限制和日志保留策略。正式使用前测试工具调用、长上下文、429 退避和模型切换，并确保配置文件权限不会向其他本机用户开放。