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

# 通过 CometAPI 使用 Hermes Agent

> 使用本指南通过 OpenAI 兼容聊天或 Anthropic 消息设置将 Hermes Agent 连接到 CometAPI。

将 [CometAPI](https://www.cometapi.com) 用作 [Hermes Agent](https://hermes-agent.nousresearch.com/docs/) 的模型提供商。在本指南中，Hermes 支持两种 CometAPI 接入方式：适用于大多数文本模型的通用 OpenAI 兼容端点，以及通过 Anthropic 消息接入 Claude 的路径。

## 前提条件

* Git
* 拥有有效 API key 的 CometAPI 账户
* macOS、Linux 或 WSL2 上的终端

## 安装

<Steps>
  <Step title="获取你的 CometAPI API key">
    登录 [CometAPI 控制台](https://www.cometapi.com/console/token)。点击 **Add API Key**，然后复制你的 CometAPI API key。

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="显示 Add API Key 按钮的 CometAPI 控制台" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="显示 base URL 的 CometAPI API key 详情" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="安装 Hermes Agent">
    以下命令会运行官方安装程序：

    ```bash theme={null}
    curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    ```

    如果当前 shell 还无法识别 `hermes` 命令，请重新加载 shell 配置：

    ```bash theme={null}
    source ~/.zshrc
    # or
    source ~/.bashrc
    ```

    <Note>
      Hermes 会将配置存储在 `~/.hermes/` 中，在 `~/.local/bin` 中链接 `hermes` 命令，并且可能会将 `~/.local/bin` 添加到你的 shell PATH 中。
    </Note>
  </Step>
</Steps>

## 配置

选择与模型家族匹配的 CometAPI 路由：

| 模型家族                   | Hermes 配置                                                                         | CometAPI 路由                 |
| ---------------------- | --------------------------------------------------------------------------------- | --------------------------- |
| OpenAI-compatible 文本模型 | `model.provider: custom` 且 `base_url: https://api.cometapi.com/v1`                | `/v1/chat/completions`      |
| Claude 模型              | 具名 provider，使用 `transport: anthropic_messages`                                    | `/v1/messages`              |
| Hermes 中的 Gemini 模型    | 使用 OpenAI-compatible 配置                                                           | `/v1/chat/completions`      |
| 直接调用 Gemini API        | 在 Hermes 之外使用 [Gemini `generateContent` API](/api/text/gemini-generating-content) | `/v1beta` `generateContent` |

<Warning>
  不要将 Hermes 配置为使用 `https://api.cometapi.com/v1beta` 的自定义 Gemini 原生 provider。对于 Gemini 模型，请使用 OpenAI-compatible 的 Hermes 配置。对于直接调用 Gemini API，请使用 [Gemini `generateContent` API](/api/text/gemini-generating-content)。
</Warning>

<Steps>
  <Step title="存储你的 CometAPI 密钥">
    打开 `~/.hermes/.env` 并添加以下值：

    ```dotenv theme={null}
    COMETAPI_KEY=<COMETAPI_KEY>
    OPENAI_API_KEY=<COMETAPI_KEY>
    ```

    `COMETAPI_KEY` 由具名 Claude provider 使用。`OPENAI_API_KEY` 可保持 Hermes 的自定义 OpenAI-compatible 端点回退机制正常工作。
  </Step>

  <Step title="配置 OpenAI-compatible 路由">
    对于大多数 CometAPI 文本模型（包括从 Hermes 中使用的 Gemini 模型），请使用此路由。打开 `~/.hermes/config.yaml` 并确保 `model` 部分如下所示：

    ```yaml theme={null}
    model:
      provider: custom
      default: your-model-id
      base_url: https://api.cometapi.com/v1
    ```

    将 `your-model-id` 替换为来自 [CometAPI Models page](https://www.cometapi.com/models/) 的当前文本 model ID。

    <Note>
      将 API 密钥保存在 `~/.hermes/.env` 中。不要在 `config.yaml` 中硬编码密钥。
    </Note>

    <Note>
      此设置用于配置主聊天模型。Hermes 还可以为视觉或网页提取等任务使用单独的辅助模型。
    </Note>
  </Step>

  <Step title="配置 Claude Messages 路由">
    当你希望 Hermes 通过 Anthropic Messages 调用 Claude 模型时，请使用此路由。打开 `~/.hermes/config.yaml` 并使用具名 provider：

    ```yaml theme={null}
    model:
      provider: cometapi-claude
      default: your-claude-model-id

    providers:
      cometapi-claude:
        base_url: https://api.cometapi.com
        key_env: COMETAPI_KEY
        transport: anthropic_messages
        default_model: your-claude-model-id
    ```

    将 `your-claude-model-id` 替换为来自 [CometAPI Models page](https://www.cometapi.com/models/) 的当前 Claude model ID。

    <Note>
      对于此路由，请将 `base_url` 保持为 `https://api.cometapi.com`。Hermes 会通过该具名 provider 使用 Anthropic Messages transport。
    </Note>
  </Step>
</Steps>

## 验证

<Steps>
  <Step title="检查配置">
    以下命令可确认 Hermes 能够读取配置和 API 密钥：

    ```bash theme={null}
    hermes config check
    ```

    如果 `hermes config check` 在更新后报告缺少选项，请运行 `hermes config migrate`，然后再次检查。
  </Step>

  <Step title="运行真实聊天测试">
    以下命令会通过 CometAPI 发送真实请求：

    ```bash theme={null}
    hermes chat -Q --ignore-rules --max-turns 1 -q "Reply with CONNECTED only."
    ```

    配置成功时会返回 `CONNECTED`，且不会出现 auth 或 endpoint 错误。当 Claude Messages 配置处于激活状态时，这也可确认 Hermes 能够通过 CometAPI 使用 `anthropic_messages` transport。
  </Step>
</Steps>

## 可选配置

<AccordionGroup>
  <Accordion title="清理重装（可选）">
    如果你要替换较旧版本的 Hermes 安装，请先使用内置卸载程序：

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

    在卸载程序中，选择 **Full uninstall** 以移除 CLI、PATH 条目以及 `~/.hermes/` 数据。然后重新运行安装步骤，并继续使用相同的 CometAPI 配置。
  </Accordion>

  <Accordion title="改为使用 hermes model（可选）">
    如果你更喜欢 OpenAI 兼容路由的交互式流程，请运行 `hermes model` 并选择 **Custom endpoint**。

    然后输入以下值：

    * Base URL: `https://api.cometapi.com/v1`
    * API key: 你的 CometAPI API key
    * Model: 当前可用的 CometAPI 文本 model ID

    此流程会将 OpenAI 兼容 provider 设置写入 `config.yaml`。对于 Claude Messages，请直接编辑 `config.yaml`，以便命名 provider 保持 `transport: anthropic_messages`。
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#howto",
        "name": "将 Hermes Agent 与 CometAPI 一起使用",
        "description": "使用本指南，通过 OpenAI 兼容聊天或 Anthropic 消息设置，将 Hermes Agent 连接到 CometAPI。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-1",
            "position": 1,
            "name": "获取你的 CometAPI API key",
            "text": "创建或打开你的 CometAPI 账户，然后从控制台复制一个有效的 API key。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-2",
            "position": 2,
            "name": "安装 Hermes Agent",
            "text": "完成“将 Hermes Agent 与 CometAPI 一起使用”指南中的“安装 Hermes Agent”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-3",
            "position": 3,
            "name": "存储你的 CometAPI key",
            "text": "完成“将 Hermes Agent 与 CometAPI 一起使用”指南中的“存储你的 CometAPI key”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-4",
            "position": 4,
            "name": "配置 OpenAI 兼容路由",
            "text": "完成“将 Hermes Agent 与 CometAPI 一起使用”指南中的“配置 OpenAI 兼容路由”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-5",
            "position": 5,
            "name": "配置 Claude Messages 路由",
            "text": "完成“将 Hermes Agent 与 CometAPI 一起使用”指南中的“配置 Claude Messages 路由”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-6",
            "position": 6,
            "name": "检查配置",
            "text": "完成“将 Hermes Agent 与 CometAPI 一起使用”指南中的“检查配置”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/hermes-agent#step-7",
            "position": 7,
            "name": "运行真实聊天测试",
            "text": "完成“将 Hermes Agent 与 CometAPI 一起使用”指南中的“运行真实聊天测试”步骤。"
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 文档",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "集成",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "将 Hermes Agent 与 CometAPI 一起使用",
            "item": "https://apidoc.cometapi.com/integrations/hermes-agent"
          }
        ]
      }
    ]
    }
    `}
</script>