Hermes Agent

Hermes Agent 是 Nous Research 的开源终端编程与任务 Agent，支持持久记忆、自建 skills，以及多消息通道网关。

ApiGo 不是 Hermes 内置 provider。推荐把它配置为 Custom endpoint（自托管 / OpenAI 兼容），或使用 OpenAI API provider 并覆盖 OPENAI_BASE_URL。

前置条件

• 已安装 Hermes（见 Hermes 文档）
• 在 工作空间 → API Keys 创建的 ApiGo API 密钥
• 选择上下文足够大的模型（Hermes 系统提示与工具 schema 占用较多 token，建议 64K+）

推荐：交互式配置

hermes model

按向导操作：

1. 选择 Custom endpoint（self-hosted / OpenAI-compatible）。
2. 填写：
   • API base URL： https://api.apigo.ai/v1
   • API key： 你的 sk-apigo-...
   • Model name： 模型目录 中支持 Chat Completions 的 slug，例如 gpt-5.6-sol
3. 启动会话：

hermes
# 或现代 TUI
hermes --tui

说明：hermes model 在会话外运行，用于完整配置 provider；会话内的 /model 只能在已经配置好的 provider 之间切换。

手动配置

1. 存放密钥

写入 ~/.hermes/.env（Hermes 约定密钥与非密钥配置分离）：

OPENAI_API_KEY=sk-apigo-...
OPENAI_BASE_URL=https://api.apigo.ai/v1

也可以把 Key 只写在下面的 config.yaml 自定义端点块中。

2. 编辑 ~/.hermes/config.yaml

方式 A：Custom endpoint（推荐写进文档的显式形态）

model:
  provider: custom
  default: gpt-5.6-sol
  base_url: https://api.apigo.ai/v1
  api_key: sk-apigo-...

方式 B：OpenAI API provider + Base URL 覆盖

model:
  provider: openai-api
  default: gpt-5.6-sol

并配合 ~/.hermes/.env 中的 OPENAI_API_KEY 与 OPENAI_BASE_URL。

3. 启动并验证

hermes chat --provider custom --model gpt-5.6-sol

发一句短提示后，到 Call Logs 确认请求。

模型 ID

使用 ApiGo 目录中支持 OpenAI 兼容接口的完整 slug，例如：

• gpt-5.6-sol
• qwen3.8-max
• deepseek-v4-flash

不要使用仅存在于其他聚合平台的别名格式。

稳定性建议

• 给 Hermes 使用的 Key 绑定带 fallback 的 路由策略，适合长会话与工具循环。
• 优先选择大上下文模型，避免启动阶段因 context 不足被拒绝。
• 在 Usage 与 Call Logs 观察成本与失败率。
• 辅助任务（摘要、标题等）若支持单独配置，可改用更便宜的模型，降低主模型成本。

故障排除

相关资源

• Hermes providers 指南
• Hermes 模型配置
• ApiGo 快速开始