跳到主要内容

Hermes Agent

Hermes Agent 是 Nous Research 开源的个人 AI Agent。它支持自定义 OpenAI 兼容端点、工具调用、终端任务和多种消息平台。

推荐：从 API Key 页面一键生成​

  1. 登录 MuskAI，进入 API 密钥。
  2. 找到要使用的密钥，点击 使用密钥。
  3. 选择 Hermes Agent 页签。
  4. 点击 下载 config.yaml，将其中的 model 配置合并到 ~/.hermes/config.yaml。

页面会自动填入当前 API Key、MuskAI Base URL 和分组默认模型。

:::warning 不要直接覆盖已有配置 如果你已经配置了 Hermes 工具、消息网关、记忆或其他 Provider，请只合并下载文件中的 model 节点。直接覆盖整个文件会丢失原有设置。 :::

手动配置​

编辑 ~/.hermes/config.yaml：

model:
  provider: custom
  default: "gpt-5.6-sol"
  base_url: "在 API 密钥页面复制的 Base URL，需以 /v1 结尾"
  api_key: "你的 MuskAI API Key"
  api_mode: chat_completions

其中：

  • default：改成当前分组实际支持的模型。
  • base_url：填写 API 基础地址，不要追加 /chat/completions 或 /responses。
  • api_mode：保持为 chat_completions。

为什么必须固定 api_mode​

Hermes 会根据 Provider、模型名和 Base URL 推断线路协议。GPT-5.x 在部分场景可能自动选择 Responses API；如果客户端仍按 Chat Completions 的 finish_reason 解析流，就可能提示：

Provider returned an empty stream with no finish_reason

MuskAI 的 Hermes 配置显式设置 api_mode: chat_completions，让请求与流式响应使用同一套协议，避免 /v1/responses SSE 与 Chat Completions 解析器混用。

安装与启动​

安装方式请以 Hermes Agent 官方仓库 的当前说明为准。安装完成并合并配置后，可运行：

hermes

也可以用模型向导检查当前配置：

hermes model

注意：新版 Hermes 以 ~/.hermes/config.yaml 为模型和端点配置来源，不要只设置旧版 OPENAI_BASE_URL 或 LLM_MODEL 环境变量。

验证​

启动 Hermes 后发送一个简单任务，例如：

请输出当前工作目录，并列出前 5 个文件。

随后在 MuskAI 使用记录中确认出现对应 API Key 的 /v1/chat/completions 请求。如果后台只有 /v1/models，说明 Hermes 仍停留在模型探测阶段，尚未真正发出推理请求。

常见问题​

空流或缺少 finish_reason​

  • 确认 api_mode 是 chat_completions。
  • Base URL 只以 /v1 结尾，不要填写完整接口路径。
  • 修改配置后完全退出并重新启动 Hermes。

401 或 403​

检查 API Key 是否完整、状态是否启用，以及密钥是否已绑定可用分组。

模型不存在​

在 API Key 页面查看该分组可用模型，并修改 model.default。不要使用只在其他分组中开放的模型名。