跳到主要内容

使用 Nous Portal 运行 Hermes Agent

本教程带你从零跑通 Nous Portal。如果你只想少配 Key、尽快使用 Hermes，这是官方推荐路线。

准备工作​

你需要：

  • 已安装 Hermes Agent；
  • 当前机器能打开浏览器，或能做 SSH 端口转发；
  • 大约 5 分钟。

你不需要单独准备 OpenAI、Anthropic、Firecrawl、FAL、Browser Use 等一堆账号。这正是 Portal 的意义。

第一步：运行 setup​

运行：

hermes setup --portal

Hermes 会引导你完成 OAuth 登录，并把 Nous Portal 写入配置。登录成功后，先检查状态：

hermes portal status

如果状态显示 provider 和 Tool Gateway 已连接，就可以进入下一步。

第二步：开始对话​

运行：

hermes chat

可以先问一个需要工具能力的问题，例如：

请搜索 Hermes Agent 最新 release，并总结升级建议。

如果 Hermes 能调用网页搜索或提取工具，说明 Portal 和 Tool Gateway 基本跑通。

第三步：切换模型​

Portal 提供多个模型。你可以在 Dashboard 中选择，也可以通过 Hermes 的模型配置界面切换。配置模型时建议遵循这个原则：

  • 主模型选择强推理、强工具调用模型；
  • 辅助模型选择快且便宜的模型；
  • 视觉、网页摘要等任务按能力单独配置。

更多说明见 配置模型。

远程服务器怎么办？​

如果 Hermes 跑在远程服务器上，而 OAuth 需要本地浏览器，可以用 SSH 端口转发。简单来说，就是把远程回调端口映射到本地，让浏览器能完成登录回跳。

官方提供了独立的 OAuth over SSH 指南，本中文站后续会继续补齐该页面。

排错建议​

如果 setup 后不能正常使用，按顺序检查：

  1. hermes portal status 是否显示登录成功；
  2. 当前 profile 是否使用 Portal provider；
  3. Dashboard 和 CLI 是否使用同一个 Hermes home；
  4. 是否有旧环境变量覆盖了 provider；
  5. 网络环境是否阻止 OAuth 回调或 Portal API。

不要一上来同时改很多配置。一次只改一个变量，更容易定位问题。

参考链接​