Hermes Agent

通过 Hermes Agent 中兼容 OpenAI 的自定义端点选项运行它。

Nous Research 出品的 Hermes Agent

支持的功能

Hermes 通过自定义服务商使用 OneProvider，采用 Chat Completions 模式，并使用您从目录中选择的兼容模型 ID。

客户端限制

请保持 API 模式为 Chat Completions；Hermes 的其他服务商模式不会使用这个兼容 OpenAI 的连接。

设置

1. 打开 Hermes 模型设置

   运行模型向导，并选择 Custom endpoint (self-hosted / VLLM / etc.)（自定义端点：自托管 / VLLM 等）。

   hermes model

2. 填写 OneProvider 连接信息

   使用 https://api.oneprovider.dev/v1、您的专用 OneProvider 密钥、您从目录中选好的兼容模型 ID，并把 API 模式设为 Chat Completions。

   Endpoint: https://api.oneprovider.dev/v1
   API key: sk-your-key-here
   Model: gpt-6.1-terra
   Mode: Chat Completions

3. 或者手动配置 Hermes

   把 ONEPROVIDER_API_KEY=… 保存到 ~/.hermes/.env，然后在 ~/.hermes/config.yaml 中设置 model 块。

   # ~/.hermes/.env
   ONEPROVIDER_API_KEY=sk-your-key-here
   # ~/.hermes/config.yaml
   model:
   default: gpt-6.1-terra
   provider: custom
   base_url: https://api.oneprovider.dev/v1
   key_env: ONEPROVIDER_API_KEY

验证连接

开始一个新的 Hermes 会话

问一个简短的问题，然后在 OneProvider 仪表板中确认所配置的模型 ID、token 用量和实际扣费金额。

连接信息

协议

openai-chat

接口地址

https://api.oneprovider.dev/v1

密钥安全

请使用专用的推理密钥，仅限所需的模型，并设置速率、消费和有效期限制。请把密钥保存在 ~/.hermes/.env，而不是 config.yaml。

如何选择模型

在 config.yaml 的 model 块中设置 default。gpt-6.1-terra 是不错的日常默认选择，gpt-6.1-sol 是旗舰档，适合困难任务，gpt-5.6-luna 价格低廉，适合快速或大批量的工作。API 模式请使用 Chat Completions，并从模型页面 复制 ID。

常见错误与解决办法

401

密钥没有被读取：请检查 ONEPROVIDER_API_KEY=… 是否在 ~/.hermes/.env 中，以及 config.yaml 里的 key_env 是否指向同一个变量。

404

base_url 必须是带 /v1 的 https://api.oneprovider.dev/v1。

“Model not found”

该 ID 不在目录中，或者有拼写错误。请从模型页面复制。

429 “Insufficient balance”

余额或密钥的限额已用完。请为个人中心充值余额。

向导里没有列出 OneProvider

在 hermes model 中选择 Custom endpoint：OneProvider 是作为自定义的、兼容 OpenAI 的端点添加的。

常见问题

密钥放在哪里？

放在 ~/.hermes/.env 中，不要放在 config.yaml 里。

能使用 Claude 模型吗？

可以，在同一个自定义端点中填写 Claude ID，例如 claude-sonnet-5-5；具体能力取决于模型。

怎样检查是否生效？

开始一个新会话，问一个简短的问题，然后在仪表板的“用量”中查找该请求。

快速解答

该使用哪个 base URL？

Claude Code 和 Anthropic SDK 使用 https://api.oneprovider.dev。OpenAI SDK 和兼容 OpenAI 的客户端使用 https://api.oneprovider.dev/v1。同一个密钥可用于这两个地址；模型列表见模型页面 ，费率见价格页面 。

如何进行身份验证？

将完整的 sk-… 密钥放在 x-api-key 或 Authorization: Bearer 中，二选一，不要同时使用。请把密钥存放在环境变量中，不要写进会被提交的文件。了解更多身份验证说明 。

在哪里获取密钥？

在 Telegram 机器人 @oneprovider_robot 或 app.oneprovider.dev 打开您的个人中心，为余额充值，然后点击“签发密钥”。每个密钥都可以设置各自的消费限额。个人中心与 API 密钥 。

401、404 和 429 是什么意思？

401：密钥缺失、拼写有误或放错了请求头；请粘贴完整的密钥，不要带引号或空格。404：通常是 base URL 不对，例如缺少或重复了 /v1。429 且提示“Insufficient balance”：个人中心余额或密钥的消费限额已用完，请充值，不要反复重试；其他 429 属于速率限制，请等待 Retry-After 指定的时间。详情见：错误码 和故障排查 。

流式输出为什么会中断或被重置？

VPN 和 VLESS 代理常常会缓冲 SSE，或破坏 HTTP/2 协商。OneProvider 没有地区限制，也不会缓冲流式输出，请关闭代理后重试。

以上都没解决，该去哪里咨询？

请在 Telegram 联系 @Oneproviderhelpbot ，或在网页个人中心打开“客服”，并附上 HTTP 状态码和完整的错误信息。客服如何运作 。