准备
安装并完成 Hermes Agent 的基础初始化,准备 APIONE API Key 和一个支持工具调用的模型 ID。不同发行版本的安装方式请以 Hermes Agent 官方项目 为准。运行模型配置向导
如果向导提供协议选项,选择 OpenAI 兼容的 Chat Completions。使用 APIONE 自定义端点和 API Key 即可,无需额外的 OAuth 登录。

Hermes Agent 的 Custom endpoint 向导。输入 APIONE Base URL 后,再填写 API Key。
验证对话和工具
重新启动hermes,先发送“只回复 OK”。成功后让它列出测试目录中的文件,逐项确认工具授权与结果。随后才连接消息渠道或配置长任务。
常见问题
- 模型不在列表:使用手动填写 ID,或检查当前密钥的模型权限。
- 对话正常、工具失败:确认所选模型支持工具调用,检查客户端发送的工具参数。
- 修改后仍请求旧服务:重新运行模型向导,确认当前会话实际选择的提供商,并重启会话。
- HTTP 401 / 404:分别检查密钥以及 /v1 路径,避免在 Base URL 中追加 /chat/completions。
返回集成目录 · 模型选择 · 错误排查

