跳转到主要内容

准备

安装并完成 Hermes Agent 的基础初始化,准备 APIONE API Key 和一个支持工具调用的模型 ID。不同发行版本的安装方式请以 Hermes Agent 官方项目 为准。

运行模型配置向导

选择 Custom endpoint,再选择手动输入地址,依次填写: 如果向导提供协议选项,选择 OpenAI 兼容的 Chat Completions。使用 APIONE 自定义端点和 API Key 即可,无需额外的 OAuth 登录。
Hermes Agent 终端提示填写 APIONE Base URL 和 API Key

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

验证对话和工具

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

常见问题

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

返回集成目录 · 模型选择 · 错误排查