ByteNoteByteNote
字

字节笔记本

2026年6月21日

hermes教程-使用 Nous Portal 运行 Hermes Agent

#Claude Code
API中转
¥120
每日科技简报 · 每天一篇,快速了解科技圈大事

本指南将引导您从头到尾在 Nous Portal 订阅上运行 Hermes Agent——从注册到验证每个工具是否正确路由。如果您只想了解 Portal 是什么以及订阅包含哪些内容，请参阅 Nous Portal 集成页面。本页面是任务脚本。

先决条件

  • 已安装 Hermes Agent（快速入门）
  • 在您设置的机器上有一个 Web 浏览器（或 SSH 端口转发——参见 通过 SSH 的 OAuth）
  • 大约 5 分钟

您不需要：OpenAI 密钥、Anthropic 密钥、Firecrawl 账户、FAL 账户、Browser Use 账户或任何其他供应商凭据。这正是关键所在。

1. 获取订阅

打开 portal.nousresearch.com/manage-subscription，注册并选择一个方案。

已经订阅？跳到第 2 步。

2. 运行一次性设置

bash
hermes setup --portal

这个单一命令完成五件事：

  1. 打开您的浏览器到 portal.nousresearch.com 进行 OAuth 登录
  2. 将刷新令牌存储在 ~/.hermes/auth.json
  3. 在 ~/.hermes/config.yaml 中设置 model.provider: nous
  4. 选择一个默认的智能体模型（anthropic/claude-sonnet-4.6 或类似）
  5. 为网络搜索、图像生成、TTS 和浏览器自动化启用工具网关

完成后，您将回到终端，准备开始对话。

如果我通过 SSH 连接到服务器怎么办？

OAuth 需要浏览器，但回环回调在运行 Hermes 的机器上执行。两种选择：

bash
## 选项 A：SSH 端口转发（推荐）
ssh -N -L 8642:127.0.0.1:8642 user@remote-host    # 在本地终端中
hermes setup --portal                              # 在远程机器上，在本地浏览器中打开打印的 URL
## 选项 B：手动粘贴（适用于 Cloud Shell、Codespaces、EC2 Instance Connect）
hermes auth add nous --type oauth --manual-paste
## 然后重新运行 `hermes setup --portal` 来连接提供者和网关

有关完整指南（包括 ProxyJump 链、mosh/tmux 和 ControlMaster 陷阱），请参阅 通过 SSH 的 OAuth / 远程主机。

3. 验证是否成功

bash
hermes portal info

您应该看到：

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

  Tool Gateway
  ────────────
  Web search & extract  via Nous Portal
  Image generation      via Nous Portal
  Text-to-speech        via Nous Portal
  Browser automation    via Nous Portal

如果任何一行显示的不是 "via Nous Portal"，或者认证行显示 "未登录"，请跳转到下面的 故障排除。

4. 运行您的第一次对话

bash
hermes chat

尝试一些同时使用模型和工具网关的操作：

嘿，搜索网络 "Hermes Agent release notes" 并总结前 3 条结果。

您应该看到 Hermes 调用 web_search（通过网关，由 Firecrawl 支持）并返回摘要。如果搜索运行且响应合理，您就完成了——Portal 已端到端连接。

5. 选择您真正想要的模型

hermes setup --portal 允许您在设置期间选择模型，但订阅的重点是访问完整目录——随时在会话中使用 /model 切换：

bash
/model anthropic/claude-sonnet-4.6     # 最佳通用智能体
/model openai/gpt-5.4                  # 强推理 + 工具调用
/model google/gemini-2.5-pro           # 大上下文窗口
/model deepseek/deepseek-v3.2          # 高性价比编码器
/model anthropic/claude-opus-4.6       # 处理难题的重型模型

或者弹出选择器浏览：

bash
/model

永久更改默认模型：

bash
## 在终端中，在任何会话之外
hermes config set model.default anthropic/claude-sonnet-4.6

不要为智能体工作选择 Hermes-4

Hermes-4-70B 和 Hermes-4-405B 在 Portal 上以大幅折扣提供，但它们是聊天/推理模型，而非工具调用调优模型。它们会在多步智能体循环中遇到困难。通过 Nous Chat 用于对话/研究工作，或通过 订阅代理 从非智能体工具使用。对于 Hermes Agent 本身，请坚持使用上述前沿智能体模型。

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

6. （可选）自定义工具网关路由

网关是按工具选择加入的，而非全有或全无。如果您已有 Browserbase 账户并希望继续使用它，同时通过 Nous 路由网络搜索和图像生成，这是支持的：

bash
hermes tools
## → Web search       → "Nous Subscription"     （推荐）
## → Image generation → "Nous Subscription"     （推荐）
## → Browser          → "Browserbase"           （您现有的密钥）
## → TTS              → "Nous Subscription"     （推荐）

这些行甚至在您登录 Nous Portal 之前就会出现在 hermes tools 中——如果您在没有活动会话的情况下选择 "Nous Subscription"，Hermes 会内联运行 Portal 登录（不会更改您的推理提供者或其他工具）。

使用以下命令验证您的混合配置：

bash
hermes portal tools

您将看到每个工具的路由——通过订阅路由的显示 via Nous Portal，使用您自己密钥的显示合作伙伴名称（browserbase、firecrawl 等）。

7. （可选）启用语音模式

由于工具网关包含 OpenAI TTS，语音模式 无需单独的 OpenAI 密钥即可工作：

bash
hermes setup voice
## → 为 TTS 选择 "Nous Subscription"
## → 选择一个语音转文本后端（本地 faster-whisper 免费，无需设置）

然后，在任何消息平台会话（Telegram、Discord、Signal 等）中，发送一条语音消息，Hermes 将转录它、回复，并用合成语音回复——全部通过您的 Portal 订阅。

8. （可选）Cron + 始终在线工作流

Portal 订阅适用于 cron 作业 和 批处理，与交互式聊天相同——OAuth 刷新令牌会自动重用。无需额外设置；只需安排 cron 作业，它们将计入您的订阅。

bash
hermes cron create "every day at 9am" \
  "搜索网络获取顶级 AI 新闻并总结最重要的 5 条故事" \
  --name "每日 AI 新闻"

cron 作业无人值守运行，通过您的 Portal 订阅调用模型 + 网络搜索 + 摘要。

配置文件和多人设置

如果您使用 Hermes 配置文件（例如每个项目一个单独的配置），Portal 刷新令牌会通过共享令牌存储自动在所有配置文件之间共享。在任何配置文件上登录一次，其他配置文件会自动获取。

对于多个人共享一台机器的团队设置，每个人都有自己的 Portal 账户 → 每个主目录持有自己的 ~/.hermes/auth.json → 用户之间不共享令牌。这是正确的边界。

故障排除

hermes setup --portal 后 hermes portal info 显示 "未登录"

OAuth 流程未完成。重新运行：

bash
hermes portal

如果您的浏览器未打开或回调失败，您可能位于远程/无头主机上——请参阅 通过 SSH 的 OAuth 了解端口转发和手动粘贴的解决方法。

"Model: currently openrouter"（或其他提供者）而不是 "using Nous as inference provider"

您的本地配置发生了偏移。OAuth 已成功，但 model.provider 仍指向其他提供者。修复：

bash
hermes config set model.provider nous

或交互式：

bash
hermes model
## 选择 Nous Portal

使用 hermes portal info 重新验证。

工具网关工具显示合作伙伴名称而不是 "via Nous Portal"

每个工具的配置覆盖了网关。运行：

bash
hermes tools
## 为任何您希望网关路由的工具选择 "Nous Subscription"

有些用户有意混合——例如通过 Nous 路由网络，但使用自己的 Browserbase 密钥进行浏览器。如果这是有意的，请保持原样。如果不是，此命令会修复它。

会话中提示 "需要重新认证"

您的 Portal 刷新令牌已失效（密码更改、手动撤销、会话过期）。令牌现在在本地被隔离，因此 Hermes 不会无限重放它。只需重新登录：

bash
hermes auth add nous

成功重新登录后，隔离会自动清除。

/model 选择器中找不到我想要的模型

Portal 目录镜像了 OpenRouter 的模型列表（300+）。如果缺少某个模型，请尝试直接输入 OpenRouter 风格的 slug：

bash
/model anthropic/claude-opus-4.6
/model openai/o1-2025-12-17

如果某个模型确实不可用，请提交问题——大多数差距是我们可更新的路由配置。

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

hermes portal info 会告诉您是否实际通过 Portal 或其他提供者路由。常见原因：

  • model.provider 设置为 openrouter/anthropic/等，而不是 nous
  • OAuth 刷新失败，回退到其他配置的提供者
  • 多个 Hermes 配置文件，您使用了错误的配置文件（检查 hermes profile current）

想要撤销并重新开始

bash
hermes auth remove nous       # 清除本地刷新令牌
## 然后重新运行设置或从 Portal Web UI 移除订阅

这为您带来了什么，用数字说明

无 Portal有 Portal
1× OpenRouter / Anthropic / OpenAI 密钥在 .env 中1× OAuth 刷新令牌，无 .env 密钥
1× Firecrawl 密钥用于网络网络通过网关路由
1× FAL 密钥用于图像生成图像生成通过网关路由
1× Browser Use / Browserbase 密钥用于浏览器浏览器通过网关路由
1× OpenAI 密钥用于 TTS / 语音模式TTS 通过网关路由
5 个独立仪表板、充值、发票1 个订阅，1 张发票
跨机器：复制所有 5 个密钥跨机器：重新 OAuth 一次

这就是交易。如果您无论如何都在使用超过两个后端，订阅物有所值。

另请参阅

Claude Code
上一篇

hermes教程-回退提供商

下一篇

hermes教程-使用 Nous Portal 运行 Hermes Agent

分享: