Hermes 使用指南

Hermes 是一款 AI Agent 工具，支持通过自定义 OpenAI-compatible 接口接入 TokenFlux。

安装

按系统选择官方安装脚本：

bash

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后重新打开终端，让 PATH 更新生效。默认配置目录为：

系统	配置目录
macOS / Linux / WSL	`~/.hermes`
原生 Windows 安装	`%LOCALAPPDATA%\hermes`

设置了 HERMES_HOME 时，使用该变量指定的目录。下文中的 config.yaml 和 .env 都位于此配置目录。

编辑配置目录中的 config.yaml，写入或确认以下配置：

yaml

model:
  default: 'gpt-6-astra'
  provider: 'custom'
  base_url: 'https://tokenflux.dev/v1'

保存配置后，可运行以下命令验证：

bash

hermes config check
hermes chat -Q -q '只回复 OK' --max-turns 3

hermes config check 检查本地配置；hermes chat 会发起真实模型请求并产生计费。收到模型回复后，可在使用记录中核对请求。

如果客户端提示 API Key 被拒绝，请继续查看 Provider said 后的服务端消息。订阅绑定失效等计费错误也可能显示在这一提示下，具体处理见错误码和余额与计费。