Skip to main content
Hermes Agent 是 Nous Research 出的多供应商 AI Agent 框架，支持 OAuth、API key、自定义 endpoint 等多种接入方式，可以接 Telegram / Discord / Slack / WhatsApp / Signal 等通讯平台。 对接 FortAPI 最稳妥的方式是用 Hermes 的 “Custom endpoint”（OpenAI 兼容）模式。

​
前置条件

1

FortAPI 账号 + API key

控制台 → 令牌 创建一把 sk-...。
2

操作系统

Linux / macOS / WSL2 全支持。原生 Windows 仍是 early beta，遇到坑建议切 WSL2。

​
安装 Hermes

一行安装：
装完重载 shell：
验证：

​
配置 FortAPI 端点

跑配置向导：
按下面顺序选：
1

选 'Custom endpoint'

向导会列出所有内置 provider（Nous Portal / OpenRouter / Anthropic / OpenAI / …）。下拉到底部，选 Custom endpoint (self-hosted / VLLM / etc.)。
2

填 base URL

因为走的是 OpenAI 兼容协议，末尾 必须 带 /v1。
3

填 API key

粘贴你的 FortAPI 令牌 sk-...。Hermes 会把它存到 ~/.hermes/.env。
4

给 endpoint 起个名

比如 FortAPI。Hermes 会自动建一个对应的 credential pool。
5

选模型

向导会问要默认用哪个 model。常用：
  • gpt-5（OpenAI 系）
  • claude-sonnet（Anthropic 系，OpenAI 兼容协议下也能调）
  • deepseek-chat、kimi-k2.5、glm-5 等
完整列表在主站 价格 页。
向导写完会自动把配置存到 ~/.hermes/config.yaml：

​
第一次验证

启动 CLI：
进交互界面后随便问一句：
正常拿到回复 + FortAPI 控制台 → 日志 有对应记录 = 成功。

​
切换模型

会话内：
或者退出会话，重跑 hermes model 改默认。

​
配置 Telegram / Discord 等渠道

模型对接完之后，跑 gateway 设置：
按向导填 Telegram Bot Token 等，gateway 跑起来后，发消息就会用 FortAPI 处理。详见 Hermes Messaging Gateway 文档。

​
常见问题

  • 确认 ~/.hermes/.env 里那一行 API key 是你的 FortAPI 令牌，没拼错。
  • 控制台 → 令牌 看 key 状态。
  • 模型 ID 没在 FortAPI 上线。去主站 价格 页看可用列表。
  • base_url 末尾要带 /v1。
Hermes 内置的 Anthropic 走 OAuth + Claude Max 订阅，对接第三方 Anthropic 兼容网关需要额外的 base URL 覆盖、不一定稳。Custom endpoint（OpenAI 兼容） 在 FortAPI 上是最直接的路径，Claude 系列模型同样可用。
Hermes 支持多 provider 共存。再跑 hermes model 加一个就行，会话内 /model 切换。
OpenAI 兼容协议下，function calling 完整透传。如果某个工具调用失败，先检查模型本身是否支持 tool use（gpt-5、claude-sonnet 都支持）。

​
进阶

  • Auxiliary models：Hermes 的 vision / web search / MoA 用辅助模型，默认跟主模型走，要省钱可单独换便宜模型，参考 Auxiliary Models。
  • Credential pools：多 key 轮询、自动 failover，配置见 Credential Pools。