> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent 接入 APIONE

> 以自定义 OpenAI 兼容端点配置 Hermes Agent。

## 准备

安装并完成 Hermes Agent 的基础初始化，准备 APIONE API Key 和一个支持工具调用的模型 ID。不同发行版本的安装方式请以 [Hermes Agent 官方项目](https://github.com/NousResearch/hermes-agent) 为准。

## 运行模型配置向导

```bash theme={null}
hermes model
```

选择 **Custom endpoint**，再选择手动输入地址，依次填写：

| 配置项 | 值 |
| - | - |
| API Base URL | [https://api.apione.ai/v1](https://api.apione.ai/v1) |
| API Key | 自己的 APIONE API Key |
| Model | APIONE 实际模型 ID |

如果向导提供协议选项，选择 OpenAI 兼容的 Chat Completions。使用 APIONE 自定义端点和 API Key 即可，无需额外的 OAuth 登录。

![Hermes Agent 终端提示填写 APIONE Base URL 和 API Key](https://mintcdn.com/apione/l_tpyU_NU9GJriKq/images/integrations/screenshots/hermes-apione-custom-endpoint.png?fit=max\&auto=format\&n=l_tpyU_NU9GJriKq\&q=85\&s=184463d03b20c748744cce9ba4c9a550)

Hermes Agent 的 Custom endpoint 向导。输入 APIONE Base URL 后，再填写 API Key。

## 验证对话和工具

重新启动 `hermes`，先发送“只回复 OK”。成功后让它列出测试目录中的文件，逐项确认工具授权与结果。随后才连接消息渠道或配置长任务。

## 常见问题

* 模型不在列表：使用手动填写 ID，或检查当前密钥的模型权限。
* 对话正常、工具失败：确认所选模型支持工具调用，检查客户端发送的工具参数。
* 修改后仍请求旧服务：重新运行模型向导，确认当前会话实际选择的提供商，并重启会话。
* HTTP 401 / 404：分别检查密钥以及 /v1 路径，避免在 Base URL 中追加 /chat/completions。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.