Skip to main content
将 CometAPI 用作 Hermes Agent 的模型提供商。在本指南中，Hermes 支持两种 CometAPI 接入方式：适用于大多数文本模型的通用 OpenAI 兼容端点，以及通过 Anthropic 消息接入 Claude 的路径。

​
前提条件

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

​
安装

1

获取你的 CometAPI API key

登录 CometAPI 控制台。点击 Add API Key，然后复制你的 CometAPI API key。
显示 Add API Key 按钮的 CometAPI 控制台
显示 base URL 的 CometAPI API key 详情
2

安装 Hermes Agent

以下命令会运行官方安装程序：
如果当前 shell 还无法识别 hermes 命令，请重新加载 shell 配置：
Hermes 会将配置存储在 ~/.hermes/ 中，在 ~/.local/bin 中链接 hermes 命令，并且可能会将 ~/.local/bin 添加到你的 shell PATH 中。

​
配置

选择与模型家族匹配的 CometAPI 路由：
不要将 Hermes 配置为使用 https://api.cometapi.com/v1beta 的自定义 Gemini 原生 provider。对于 Gemini 模型，请使用 OpenAI-compatible 的 Hermes 配置。对于直接调用 Gemini API，请使用 Gemini generateContent API。
1

存储你的 CometAPI 密钥

打开 ~/.hermes/.env 并添加以下值：
COMETAPI_KEY 由具名 Claude provider 使用。OPENAI_API_KEY 可保持 Hermes 的自定义 OpenAI-compatible 端点回退机制正常工作。
2

配置 OpenAI-compatible 路由

对于大多数 CometAPI 文本模型（包括从 Hermes 中使用的 Gemini 模型），请使用此路由。打开 ~/.hermes/config.yaml 并确保 model 部分如下所示：
将 your-model-id 替换为来自 CometAPI Models page 的当前文本 model ID。
将 API 密钥保存在 ~/.hermes/.env 中。不要在 config.yaml 中硬编码密钥。
此设置用于配置主聊天模型。Hermes 还可以为视觉或网页提取等任务使用单独的辅助模型。
3

配置 Claude Messages 路由

当你希望 Hermes 通过 Anthropic Messages 调用 Claude 模型时，请使用此路由。打开 ~/.hermes/config.yaml 并使用具名 provider：
将 your-claude-model-id 替换为来自 CometAPI Models page 的当前 Claude model ID。
对于此路由，请将 base_url 保持为 https://api.cometapi.com。Hermes 会通过该具名 provider 使用 Anthropic Messages transport。

​
验证

1

检查配置

以下命令可确认 Hermes 能够读取配置和 API 密钥：
如果 hermes config check 在更新后报告缺少选项，请运行 hermes config migrate，然后再次检查。
2

运行真实聊天测试

以下命令会通过 CometAPI 发送真实请求：
配置成功时会返回 CONNECTED，且不会出现 auth 或 endpoint 错误。当 Claude Messages 配置处于激活状态时，这也可确认 Hermes 能够通过 CometAPI 使用 anthropic_messages transport。

​
可选配置

如果你要替换较旧版本的 Hermes 安装，请先使用内置卸载程序：
在卸载程序中，选择 Full uninstall 以移除 CLI、PATH 条目以及 ~/.hermes/ 数据。然后重新运行安装步骤，并继续使用相同的 CometAPI 配置。
如果你更喜欢 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。