hermes教程-Nous Portal

Nous Portal 是 Nous Research 的统一订阅网关，也是运行 Hermes Agent 的推荐方式。一次 OAuth 登录即可替代原本需要手动配置的多个独立账户、API 密钥和计费关系——涵盖每个模型实验室、搜索 API、图像生成器和浏览器提供商。

如果你只有时间设置一件事，那就设置这个。最快的路径：

hermes setup --portal

这一条命令会运行 Portal OAuth，让你选择一个 Nous 模型，在 config.yaml 中将 Nous 设置为推理提供商，并开启工具网关。之后你就可以立即使用 hermes chat。

还没有订阅？前往 portal.nousresearch.com/manage-subscription 注册，然后回来运行上面的命令。

订阅包含什么

300+ 前沿模型，统一账单

Portal 代理了来自整个生态系统的精选智能体模型目录——费用计入你的 Nous 订阅，而不是每个实验室的独立信用额度。

路由在底层通过 OpenRouter 进行，因此模型可用性和故障转移行为与你使用 OpenRouter 密钥时一致——只是费用计入你的 Nous 订阅。在会话中通过 /model 在 Claude Sonnet 4.6（用于编码）和 Gemini 3 Pro（用于长上下文）之间切换——无需新凭证，无需充值，不会出现意外的零余额错误。

Nous 工具网关

同一订阅还解锁了工具网关，它将 Hermes Agent 的工具调用通过 Nous 管理的基础设施进行路由。五个后端，一次登录：

没有网关时，连接每个工具意味着需要一个 Firecrawl 账户、一个 FAL 账户、一个 Browser Use 账户、一个 OpenAI 密钥和一个 Modal 账户——五次独立注册、五个独立仪表盘、五次独立充值流程。有了网关，所有工具都通过一个订阅路由。

你也可以只启用特定的网关工具（例如仅网页搜索而不启用图像生成）——参见下面的将网关与你自己的后端混合使用。

Nous Chat

你的 Portal 账户还覆盖了 chat.nousresearch.com——Nous Research 的网页聊天界面，使用相同的模型目录。当你不在终端前，或进行非智能体对话工作时非常有用。

你的 dotfiles 中无需凭证

因为所有内容都通过一个 OAuth 认证的 Portal 会话路由，你不需要在 .env 文件中积累十几个长期有效的 API 密钥。磁盘上唯一的凭证是 ~/.hermes/auth.json 中的刷新令牌，Hermes 每次请求都会从中生成短期 JWT——参见下面的令牌处理。

跨平台一致性

原生 Windows 上，每个工具单独设置 API 密钥是其痛点——在 Windows 上安装 Firecrawl 账户、FAL 账户、Browser Use 账户、OpenAI 密钥是让一个有用的智能体运行起来最麻烦的部分。Portal 订阅简化了这一点：一次 OAuth 覆盖模型和所有网关工具，因此 Windows 用户无需手动配置四个后端即可获得与 macOS/Linux 相同的体验。

关于 Hermes 4

Nous Research 自家的 Hermes 4 系列（Hermes-4-70B、Hermes-4-405B）可通过 Portal 以大幅折扣价格获得。这些是前沿混合推理聊天模型——在数学、科学、指令遵循、模式遵守、角色扮演和长文写作方面表现出色。

然而，不建议在 Hermes Agent 内部使用它们。Hermes 4 针对聊天和推理进行了调优，而非智能体所依赖的快速工具调用循环。请将它们用于 Nous Chat、研究工作流程，或通过订阅代理从其他工具使用——但对于智能体工作，请从目录中选择一个前沿智能体模型：

/model anthropic/claude-sonnet-4.6     # 最佳通用智能体模型
/model openai/gpt-5.5-pro              # 强推理 + 工具调用
/model google/gemini-3-pro-preview    # 超大上下文窗口
/model deepseek/deepseek-v4-pro       # 高性价比编码器

Portal 自己的模型信息页面也带有相同的警告，因此这不是 Hermes 方面的意见——而是 Nous Research 的官方指导。

设置

全新安装——一条命令

hermes setup --portal

这将一次性完成完整设置：

1. 打开你的浏览器到 portal.nousresearch.com 进行 OAuth 登录
2. 将刷新令牌存储在 ~/.hermes/auth.json
3. 让你从精选列表中选择一个 Nous 模型（或跳过以保留当前模型）
4. 在 ~/.hermes/config.yaml 中将 Nous 设置为推理提供商（当你选择模型时）
5. 开启工具网关（网页、图像、TTS、浏览器路由）
6. 返回终端，准备使用 hermes chat

如果你还没有订阅，请先在 portal.nousresearch.com/manage-subscription 注册。

现有安装——将 Portal 添加到其他提供商旁边

如果你已经配置了 Hermes 使用 OpenRouter、Anthropic 或其他提供商，并希望将 Portal 添加到它们旁边：

hermes model
## 从提供商列表中选择 "Nous Portal"
## 浏览器打开，登录，完成

你现有的提供商保持配置。你可以在会话中通过 /model 或在会话之间通过 hermes model 切换——Portal 成为你可用的提供商之一，而不是唯一的一个。

无头 / SSH / 远程设置

OAuth 需要浏览器，但回环回调在运行 Hermes 的机器上执行。对于远程主机，请参见通过 SSH / 远程主机的 OAuth——相同的模式适用于 Portal 以及任何其他基于 OAuth 的提供商（ssh -L 端口转发，--manual-paste 用于仅浏览器环境如 Cloud Shell / Codespaces）。

配置文件设置

如果你使用 Hermes 配置文件，Portal 刷新令牌将通过共享令牌存储自动在所有配置文件之间共享。在任何配置文件上登录一次，其余配置文件会自动获取——无需为每个配置文件重复 OAuth 流程。

日常使用 Portal

检查已连接的内容

hermes portal            # 登录 Nous Portal 并设置（一次性入门）
hermes portal info       # 登录状态、订阅信息、模型 + 网关路由
hermes portal status     # `portal info` 的别名
hermes portal tools      # 详细的工具网关目录，包含每个工具的路由
hermes portal open       # 在浏览器中打开订阅管理页面

hermes portal（不带子命令）是 hermes auth add nous --type oauth 的人类可读别名——它会登录，让你选择一个 Nous 模型，将 Nous 设置为推理提供商，并提供工具网关的加入选项（与 hermes setup --portal 相同，也是首次快速设置的相同 Nous 流程）。

hermes portal info 提供高级概览：

  Nous Portal
  ───────────
  Auth:    ✓ 已登录
  Portal:  https://portal.nousresearch.com
  Model:   ✓ 正在使用 Nous 作为推理提供商

  Tool Gateway
  ────────────
  Web search & extract  通过 Nous Portal
  Image generation      通过 Nous Portal
  Text-to-speech        通过 Nous Portal
  Browser automation    通过 Nous Portal
  Cloud terminal        未配置

切换模型

在会话内：

/model anthropic/claude-sonnet-4.6
/model openai/gpt-5.5-pro
/model google/gemini-3-pro-preview

或打开选择器：

/model
## 方向键，回车选择

在会话外（完整设置向导，添加新提供商时有用）：

hermes model

将网关与你自己的后端混合使用

如果你已经拥有例如 Browserbase 账户，并希望继续使用它，同时将网页搜索和图像生成通过 Nous 路由，这是支持的。使用 hermes tools 为每个工具选择后端：

hermes tools
## → Web search       → "Nous Subscription"
## → Image generation → "Nous Subscription"
## → Browser          → "Browserbase"  (你现有的密钥)
## → TTS              → "Nous Subscription"

工具网关是按工具选择加入的，而非全有或全无。无论你是否登录 Nous Portal，托管后端都会出现在 hermes tools 中——如果你在认证前选择了 "Nous Subscription"，Hermes 会内联运行 Portal 登录（它不会更改你的推理提供商或影响你的其他工具）。有关完整的每个工具配置矩阵，请参见工具网关文档。

订阅管理

随时管理你的计划、查看使用情况或升级/取消：

• 网页： portal.nousresearch.com/manage-subscription
• CLI 快捷方式： hermes portal open（在默认浏览器中打开同一页面）

配置参考

执行 hermes setup --portal 后，~/.hermes/config.yaml 将如下所示：

model:
  provider: nous
  default: anthropic/claude-sonnet-4.6     # 或你选择的任何模型
  base_url: https://inference-api.nousresearch.com/v1

工具网关设置位于各自的工具部分下：

web:
  backend: nous       # 网页搜索/提取通过工具网关路由

image_gen:
  provider: nous

tts:
  provider: nous

browser:
  backend: nous

OAuth 刷新令牌单独存储在 ~/.hermes/auth.json 中（不在 config.yaml 中——凭证和配置按设计分开保存）。

令牌处理

Hermes 在每次推理调用时从你存储的 Portal 刷新令牌生成一个短期 JWT，而不是重复使用长期有效的 API 密钥。令牌生命周期完全自动——刷新、生成、在临时 401 时重试——你永远不会看到它。

如果 Portal 使刷新令牌失效（密码更改、手动撤销、会话过期），失效的刷新令牌会在本地隔离，这样 Hermes 就不会重复使用它，你也不会看到一连串相同的 401 错误。下一次调用会显示一条清晰的“需要重新认证”消息。运行 hermes auth add nous 重新登录；隔离会在下次成功登录时清除。

故障排除

hermes portal info 显示“未登录”

你尚未完成 OAuth 流程，或者你的刷新令牌已被清除。运行：

hermes portal

或使用 hermes model 并重新选择 Nous Portal。

会话中收到“需要重新认证”消息

你的 Portal 刷新令牌已失效（密码更改、手动撤销或会话过期）。运行 hermes auth add nous，你的下一个请求将使用新凭证。旧令牌上的任何隔离会在成功重新登录时自动清除。

想使用 Portal 未公开的特定提供商模型

Portal 通过 OpenRouter 代理，因此 OpenRouter 支持的任何模型通常都可用。如果某个特定模型没有出现在 /model 中，请尝试直接使用 OpenRouter 风格的 slug：

/model anthropic/claude-opus-4.6

如果某个模型确实缺失，请提交 issue——我们将 Portal 的目录暴露给 Hermes，缺失通常意味着我们可以更新路由配置。

账单未出现在我的 Portal 账户上

首先检查 hermes portal info——如果显示你正在使用不同的提供商（Model: currently openrouter 而不是 using Nous as inference provider），则你的本地配置已漂移。运行 hermes model，选择 Nous Portal，下一个请求将通过你的订阅路由。

参见

• 工具网关 — 每个网关工具的完整详情、每个工具的配置和定价
• 订阅代理 — 从非 Hermes 工具（其他智能体、脚本、第三方客户端）使用你的 Portal 订阅
• 语音模式 — 使用 Portal 的 OpenAI TTS 进行语音对话
• AI 提供商 — 完整提供商目录，如果你想比较替代方案
• 通过 SSH 的 OAuth — 从远程主机或仅浏览器环境登录
• 配置文件 — 多个 Hermes 配置共享一个 Portal 登录