OpenRouter.help
返回首页

hermes-integration

阅读约 8 分钟

原文链接：https://openrouter.ai/docs/cookbook/coding-agents/hermes-integration

Hermes Agent

使用 Nous Research 的 Hermes Agent 连接 OpenRouter

什么是 Hermes Agent？

Hermes Agent 是由 Nous Research 构建的开源、终端原生的自主编程和任务代理。它具有持久内存、代理创建的技能，以及支持 21+ 平台的消息网关，包括 Telegram、Discord、Slack、WhatsApp、Signal、SMS、Matrix 等。

Hermes 运行在本地、Docker、SSH、Daytona、Modal、Vercel Sandbox 或 Singularity 后端，支持多种 LLM 提供商 —— 包括通过单一 API 密钥实现多模型访问的 OpenRouter。

设置

推荐方式：使用交互式模型选择器

配置 Hermes 与 OpenRouter 连接的最简单方式：

hermes model

从提供商列表中选择 OpenRouter，输入您的 API 密钥，然后选择您喜欢的模型。这是新用户的推荐方法。

快速开始（环境变量）

如果您已有 OpenRouter API 密钥：

hermes config set OPENROUTER_API_KEY sk-or-...

然后开始对话：

hermes chat --provider openrouter --model anthropic/claude-sonnet-4

手动配置

仅限高级用户：以下手动配置适用于需要直接编辑配置文件的大多数用户。对于大多数用户，我们建议使用上面的 hermes model。

步骤 1：获取您的 OpenRouter API 密钥

  1. 在 OpenRouter 注册或登录
  2. 导航到您的 API Keys 页面
  3. 创建一个新的 API 密钥
  4. 复制您的密钥（以 sk-or-... 开头）

步骤 2：设置您的 API 密钥

将您的 OpenRouter API 密钥添加到 ~/.hermes/.env：

OPENROUTER_API_KEY=sk-or-...

Hermes 将密钥与非密钥设置分离。API 密钥放在 ~/.hermes/.env 中，而模型和提供商配置放在 ~/.hermes/config.yaml 中。

步骤 3：配置您的模型

编辑 ~/.hermes/config.yaml：

model:
  provider: openrouter
  default: anthropic/claude-sonnet-4

在 openrouter.ai/models 浏览所有可用模型。

步骤 4：启动 Hermes

hermes          # 经典 CLI
hermes --tui    # 现代 TUI

您的代理现在将通过 OpenRouter 路由所有请求到您选择的模型。

模型格式

当使用 OpenRouter 作为提供商时，Hermes 使用标准 OpenRouter 模型格式 <author>/<slug>：

anthropic/claude-sonnet-4
google/gemini-3-flash-preview
deepseek/deepseek-chat
openrouter/auto (自动路由到适合您提示的最佳/最优模型)

您可以在 OpenRouter models page 找到每个模型的确切模型 ID。

提供商路由

OpenRouter 为每个模型跨多个基础设施提供商路由您的请求。您可以在 ~/.hermes/config.yaml 中控制此路由行为：

provider_routing:
  sort: "throughput"          # "price" (默认), "throughput", 或 "latency"
  # only: ["anthropic"]      # 仅使用这些提供商
  # ignore: ["deepinfra"]    # 跳过这些提供商
  # order: ["anthropic", "google"]  # 按此顺序尝试提供商
  # data_collection: "deny"  # 排除可能存储/训练数据的提供商

快捷方式：在任何模型名称后附加 :nitro 以进行吞吐量排序（例如 anthropic/claude-sonnet-4:nitro），或使用 :floor 进行价格排序。

有关路由选项的完整说明，请参阅 Provider Routing 文档。

后备提供商

配置后备提供商的链，当主要模型失败时 Hermes 会尝试：

fallback_providers:
  - provider: openrouter
    model: anthropic/claude-sonnet-4
  - provider: openrouter
    model: google/gemini-2.5-flash

这提供了一层额外的可靠性。激活后，后备会在不丢失对话的情况下切换模型。

辅助模型

Hermes 使用"辅助模型"来处理辅助任务，如上下文压缩、视觉分析、会话标题和网络摘要。默认情况下，这些使用您的主模型，但您可以通过 OpenRouter 将它们路由到更便宜的模型：

auxiliary:
  title:
    provider: openrouter
    model: google/gemini-2.5-flash
  vision:
    provider: openrouter
    model: google/gemini-2.5-flash
  compression:
    provider: openrouter
    model: google/gemini-2.5-flash

这使您的主模型专注于复杂推理，而更便宜的模型处理轻量级任务。

Pareto Code Router

OpenRouter 的实验性编码模型路由器自动将请求路由到满足编码质量阈值的最低价模型。在 ~/.hermes/config.yaml 中配置：

model:
  provider: openrouter
  model: openrouter/pareto-code

openrouter:
  min_coding_score: 0.65   # 0.0–1.0; 越高 = 越强（越贵）的编码器

这对于编码任务的成本优化很有用 —— 路由器选择满足您质量标准的最低价模型。

Hermes 使用自己的 openrouter: 配置键来设置 min_coding_score。这映射到 OpenRouter API 中的 plugins 数组 —— 您不需要自己构造 plugins payload。

监控使用情况

实时跟踪您的 Hermes 使用情况：

  • 访问 OpenRouter Activity Dashboard
  • 查看跨所有 Hermes 会话的请求、成本和 Token 使用情况
  • 按模型、时间范围或其他条件过滤

常见错误

"No API key" 或找不到提供商

Hermes 找不到您的 OpenRouter API 密钥。

修复方法：

  • 验证密钥已设置：cat ~/.hermes/.env | grep OPENROUTER
  • 或重新运行：hermes config set OPENROUTER_API_KEY sk-or-...
  • 或使用交互式设置：hermes model

认证错误 (401/403)

修复方法：

  • 在 openrouter.ai/keys 验证您的 API 密钥是否有效
  • 检查您的账户是否有足够的信用额度
  • 确保您的密钥未被过期或撤销

模型不工作

修复方法：

  • 在 OpenRouter models page 验证模型 ID
  • 使用格式 <author>/<slug>（例如 anthropic/claude-sonnet-4）
  • 确保模型可用且未被弃用

上下文长度错误

Hermes 需要至少 64K 上下文 Token 的模型。上下文窗口较小的模型将在启动时被拒绝，因为系统提示和工具 schema 会填满较小的窗口，导致对话没有空间。如果您看到上下文相关错误，请切换到具有更大上下文窗口的模型。

© 2026 OpenRouter.help
查看官方英文原件