Hermes Agent 配置
适用范围：Hermes Agent 的 custom 提供商与手动模型配置；一键脚本为独立 apizt 辅助项目。
版本与验证：2026-09-28 核对本文配置项、步骤和资料入口，补齐验证与排错说明。未在真实账号中验证付费模型调用。
配置速查
| 配置项 | 填写内容 | 注意事项 |
|---|---|---|
| OPENAI_API_KEY | apizt API Key | 写入 ~/.hermes/.env。 |
| OPENAI_BASE_URL | https://api.apizt.com/v1 | 与 config.yaml 的 base_url 一致。 |
| model.provider | custom | 手动选择自定义提供商。 |
| model.default | gpt-6-sol | 以当前模型权限为准。 |
还没有 API Key？注册获取免费体验额度 · 已注册：进入控制台创建 API Key
为此工具单独创建令牌，并设置合理额度和模型权限。截图中的模型仅作示例，以账号当前可用模型为准；不要公开密钥或上传含密钥的配置文件。
第 1 步：确认 Hermes 已安装
按 Hermes 官方说明安装并确认可以启动。本文介绍手动配置 custom 提供商。使用当前安装版本的官方配置说明核对设置。
第 2 步：配置本地凭据
编辑当前用户的 ~/.hermes/.env，合并以下变量，保留其他已有设置。
OPENAI_API_KEY=YOUR_tokenba_API_KEY
OPENAI_BASE_URL=https://api.apizt.com/v1第 3 步：配置默认模型与提供商
在 ~/.hermes/config.yaml 中修改 model 节点，不用片段覆盖整份文件。
model:
provider: "custom"
default: "gpt-6-sol"
base_url: "https://api.apizt.com/v1"custom 提供商、OpenAI 兼容端点与模型须同时满足当前 Hermes 版本要求。
第 4 步：重启并核对实际后端
关闭已有 Hermes 进程后重新启动，先发一条短消息，再测试读取 README。若使用 /model 切换模型，重新确认实际提供商；只改模型名称不足以证明请求仍走同一个后端。
连接失败时按这几步排查
运行 hermes model 配置 Custom endpoint，API base URL 为 https://api.apizt.com/v1；模型、provider 与 URL 应作为同一组设置。
- 退出当前会话，在终端运行 hermes model，选择 Custom endpoint，填写 Base URL、Key 和真实模型 ID。
- 保留 ~/.hermes/config.yaml 与 ~/.hermes/.env 的其他设置；检查 model.provider、model.default、model.base_url 是否对应同一服务。
- 新开会话确认实际 provider；会话内 /model 切换与终端 hermes model 添加提供商不是同一步操作。
容易混淆的情况
- CLI、守护进程或其他运行环境可能读取不同环境变量；终端成功时仍需核对实际运行进程。
- 短文本成功但 Agent 出错时，检查工具协议及上下文限制；上下文长度应按真实模型能力设置。
怎样确认修复成功
新会话先发短消息，再授权读取测试文件。若仍失败，查看本机 hermes logs，分享前删除密钥、私有提示词和敏感路径。
记录所装客户端版本、模型 ID、请求时间、最终路径与脱敏状态。本节为配置核对指南，未新增客户端付费调用实测；保留原文已有验证记录的适用范围。
怎样确认配置已生效
- 运行中的 Hermes 读取更新后的 .env 和 config.yaml。
- /model 显示目标模型，短消息有日志。
接入失败时逐项检查
| 现象 | 检查与处理 |
|---|---|
| 切换后 model not allowed | 核对当前令牌允许的模型与分组。 |
| 手动修改没有生效 | 重新启动 Hermes，确认配置目录和当前运行用户一致。 |
| 辅助脚本下载失败 | 改用本页手动配置；不要将辅助脚本视为 Hermes 官方安装器。 |
资料与下一步
遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID，联系支持时先隐藏 API Key。