集成

Hermes

以 Markdown 格式查看

Hermes Agent logo

将 OpenModels 作为 Hermes Agent 的上游模型供应商。Hermes 保留其 CLI、TUI、记忆、技能、终端后端、消息网关、定时任务和工具。OpenModels 提供兼容 OpenAI 的模型端点、API 密钥、模型 ID 和积分计费。

本指南聚焦 Hermes 调用 OpenModels。如果你希望其他应用通过 Hermes 的 API server 调用 Hermes，请参见下方“将 Hermes 用作 OpenAI 兼容端点”。

适用场景

当你希望实现以下目标时，请使用此配置：

  • 将 Hermes Agent 用作本地或 always-on autonomous agent。
  • 将 OpenModels 用作 Hermes 背后的模型市场。
  • 使用一个 ale-... OpenModels API 密钥进行 Hermes 模型调用。
  • 通过 https://api.getopenmodels.com/v1 使用兼容 OpenAI 的聊天补全。
  • 在 OpenModels-backed models 之上使用 Hermes 的 memory、skills、messaging platforms、web tools 和 terminal execution 等能力。

前置条件

  • 在将运行 CLI、TUI 或 gateway 的机器上安装 Hermes Agent。
  • 一个 ale-... 格式的 OpenModels API 密钥。
  • 您的 OpenModels 账户中有可用积分。
  • 一个至少具备 64K context 的受支持 OpenModels chat model。Hermes 会拒绝更小的 context window，因为多步骤 tool workflows 需要足够工作记忆。

推荐起步模型：

使用场景模型
通用 chat 和低成本测试qwen3.5-flash
Coding-heavy agent workkimi-k2.7-code
推理或更大的项目 context从 Models 页面选择 high-context reasoning model

1. 安装 Hermes

在 Linux、macOS、WSL2 或 Android Termux 上：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc   # or: source ~/.zshrc

在 Windows PowerShell 上：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

验证安装：

hermes doctor

2. 保存 OpenModels 密钥

Hermes 将 secrets 存储在 ~/.hermes/.env 中。请把 OpenModels key 放在这里：

mkdir -p ~/.hermes
printf 'OM_API_KEY=ale-your-api-key\n' >> ~/.hermes/.env

不要将真实的 ale-... 密钥提交到应用仓库。

3. 将 OpenModels 配置为命名自定义供应商

Hermes 支持自定义 OpenAI-compatible endpoints。使用命名 custom provider 可让模型引用更明确，也便于后续切换。

编辑 ~/.hermes/config.yaml：

custom_providers:
  - name: openmodels
    base_url: https://api.getopenmodels.com/v1
    key_env: OM_API_KEY
    api_mode: chat_completions
    models:
      "qwen3.5-flash":
        context_length: 1000000
      "kimi-k2.7-code":
        context_length: 256000
model:
  provider: custom:openmodels
  default: qwen3.5-flash

说明：

  • base_url 是 OpenModels base URL。
  • key_env 指向 ~/.hermes/.env 中的 OM_API_KEY。
  • api_mode: chat_completions 让 Hermes 走兼容 OpenAI 的聊天补全路径。
  • context_length 应匹配或保守适配所选模型。请以 OpenModels Models 页面作为当前来源。

如果你已有 custom_providers 或 model 配置，请将这些 key 合并到现有 YAML 中，不要添加重复的顶层 key。

4. 使用 OpenModels 启动 Hermes

启动 CLI 或 TUI：

hermes
hermes --tui

启动 banner 应显示所选 provider 和 model。发送一个容易验证的简单 prompt：

Summarize the current directory in five bullets.

如果 Hermes 正常响应并且可以使用工具，则 OpenModels-backed 配置已可工作。

5. 在会话期间切换模型

使用 Hermes 的 /model 命令切换到另一个 OpenModels model：

/model custom:openmodels:kimi-k2.7-code

切回已配置的默认值：

/model default

Hermes 会把新会话的模型选择写入 ~/.hermes/config.yaml。现有 chat sessions 可以继续使用启动时的模型，因此当你想在 active session 内切换时，请使用 /model。

6. 仅在对话正常后添加网关或自动化

当普通 CLI 或 TUI chat 正常工作后，再添加下一层 Hermes 能力：

hermes gateway setup
hermes tools
hermes skills browse

使用 hermes gateway setup 接入 Telegram、Discord、Slack、WhatsApp、Email、Home Assistant、Microsoft Teams 和其他 messaging platforms。在基础 chat 稳定前，请保持模型配置简单。

将 Hermes 用作 OpenAI 兼容端点

这是反向调用：另一个应用调用 Hermes，然后 Hermes 运行其已配置的 agent。

Hermes 为 OpenAI-compatible frontends 提供 API server 功能。在该模式下：

  • 外部应用访问 Hermes 的 API server URL。
  • Hermes 使用其已配置 provider，该 provider 可以是 OpenModels。
  • OpenModels key 保留在 ~/.hermes/.env 内，而不是放在 frontend app 中。

请区分这些 endpoints：

方向基础 URL
Hermes 直接调用 OpenModelshttps://api.getopenmodels.com/v1
另一个应用调用 Hermes你的本地或已部署 Hermes API server URL

不要在没有 authentication、network controls 和清晰 tool-permission model 的情况下公开暴露 Hermes API server。Hermes 可以运行 terminal commands、访问文件并使用已配置工具。

故障排查

症状检查项
Hermes 报告缺少 API 密钥确认 OM_API_KEY 存在于 ~/.hermes/.env 中
OpenModels 返回 401 或 invalid key确认 key 是有效的 ale-... key，并且在 OpenModels 中仍处于 active 状态
Balance 或 billing failure发送请求前向 OpenModels 账号添加 credits
Hermes 启动时拒绝模型使用至少 64K context 的 OpenModels chat model，并设置 context_length
自定义端点在其他客户端可用，但 Hermes 不可用检查 base_url、api_mode、模型 ID 和 key_env
当前 chat 一直使用旧模型在 active session 内使用 /model custom:openmodels:<model-id>
Gateway 已启动但消息失败先验证普通 hermes 或 hermes --tui，然后重新运行 hermes gateway setup

参考资料