你把 Hermes 装在一台新机器上，或者只是想在动手买 API Key 之前先感受一下它是什么手感。过去的流程是：装完先跑 hermes setup，去某个 provider 控制台注册、复制 key、粘贴进去，前后十几分钟，全花在配置上——真正想试的功能一个字都还没聊。

现在这一步可以先跳过了。Hermes 启动时会自动准备一个免费的 Nous 身份，你用默认模型就能直接开聊；等你真的需要完整模型目录和付费工具时，再花一分钟登录。

什么都不配，会发生什么

首次启动时 Hermes 会花几秒钟设置免费层，界面上显示一行 “Setting up free inference…”。完成后：

• 推理跑在一个名为 nous/welcome 的模型上；
• 状态栏和 hermes auth status 显示 Nous · free tier · nous/welcome；
• hermes model 里会出现一行 Nous · free tier，只有这一个模型。

它不弹向导、不强制你点任何东西。hermes setup 依然在，你想手动配 provider 随时可以用。

有一点需要说明：免费层正在分批放开。在它对你全面开启之前，只有进程启动时带上了 HERMES_GUEST_ONBOARDING=1 才会有上面这些行为——注意这个环境变量只认 1，写 true 不算。变量不存在时，全新安装的表现和以前完全一样：走 first-run 的 provider 选择器。

免费层给你什么，不给什么

	免费层	登录后
推理	nous/welcome（一个模型）	Nous Portal 完整模型目录
连接器（Gmail、Linear、Notion 等）	可用	可用
付费工具（联网搜索、图片生成、TTS、云端浏览器）	不可用	可用，计入你的订阅账单
额度或余额	无	有

这里的“连接器”指的是你在 Nous 门户上绑定的第三方账号，让 agent 能替你在这些系统里干活。它们在免费层不需要登录就能用——这也是免费层存在的主要理由之一。

另外，后台杂活也走同一个模型：会话压缩、聊天标题、图片理解之类的后台调用，都在 nous/welcome 上完成。

免费层永远是最后手段，不是首选。你已经配了任何 provider，它就让位：

你的情况	推理跑在	连接器
什么都没配	Nous 免费层（nous/welcome）	免费层
.env 里有 API key（OpenRouter、OpenAI、Anthropic……）	你的 key	免费层
config.yaml 里设了 model.provider	那个 provider	免费层
登录了 Nous Portal	你的账号	你的账号

已经配好 provider 的安装，启动时仍会设置一次免费层，让连接器有东西可以鉴权，但推理还是走你自己的 provider，并用一行提示告诉你这件事。

还有两个容易困惑的细节：在免费层状态下，如果 config.yaml 里的 model.default 写的是别的模型，Hermes 会照旧用 nous/welcome，并明确告诉你一行；要是你在免费层上点了个需要账号的模型，它不会偷偷切换，而是提示：

gpt-5 needs a Nous account or an API key. Use /login to sign in, or /model to pick another provider.

付费工具被调用时，聊天里会说 This needs a Nous account. Use /login to sign in.，终端里则指向 hermes auth upgrade——这一轮对话不会被中断，只是这个工具没用上。

什么时候该登录

只要免费层存在（包括你自己配了 key 的安装），登录入口都会出现在两处。

在聊天里：私聊里发 /login（Telegram、Discord、Slack 等平台；Slack 上用 /hermes login，CLI 会话里也可以）。它必须是配对过的私聊——群聊里发会被拒绝，并回一句 Sign in from a direct message with Hermes.。

你会收到三条消息：同意链接、单独一行的登录码，然后是 Do not share this code. 开头的等待提示。等待期间你可以继续聊，结果会推回同一个私聊。再发一次 /login 会替换掉上一个码。

在终端里：

hermes auth upgrade

它会打印一个 URL 和一个短码，并自动打开浏览器（--no-browser 可关，SSH 会话里也不会开）。浏览器里确认后回到终端，会看到 Signed in as [email protected].；如果你的默认模型原本是 nous/welcome，还会多一行告诉你账号现在用的模型。

登录后推理切到账号的模型目录，付费工具解锁，hermes auth status 不再显示免费层那一行。你之前手动选过的默认模型不会被改动。

两个坑值得提前知道：

1. 一个安装对应一个账号。/login 会把整个 Hermes 安装绑到批准这个码的账号上：推理、连接器、它服务的每个聊天。如果你在 gateway 上跑，多人都能私聊它，请给对应平台设 allow_admin_from，让只有运维能执行它。
2. hermes auth add nous --type oauth 也能登录，但会直接替换掉免费层，不带走你的连接器。有连接器要保留时，用 /login 或 hermes auth upgrade。

桌面端看到的四个地方

桌面 App 跑在同一个免费层上，只是把它显示在四个位置：

位置	显示内容
首次启动	一个就绪页：“Hermes is ready.”，默认模型 nous/welcome，一个 Free tier 徽标和 Begin 按钮；下面是“用 Nous 账号登录”和“其他 provider”。只显示一次。
已有 API key 时的首次启动	输入框上方一条一次性提示：“Free Nous inference and connectors are now available.”，带型号选择器、登录和忽略
状态栏	一枚 Nous · free tier · nous/welcome 芯片，带 Sign in 徽标；可以在右键菜单里隐藏
设置 › 账单	“You’re on the Nous free tier”，只有一个登录按钮；套餐显示 Free tier，模型 nous/welcome，连接器显示 Included，没有余额也没有付款入口

命令行和桌面读的是同一份本地状态，所以“一次性提示”也是共享的：在 CLI 上看过，桌面就不会再弹，反之亦然。

想关掉它

hermes config set nous.guest false

nous.guest 是一个普通的 config.yaml 配置项（默认 true），不是环境变量。关掉之后：免费推理没了、连接器不能免登录用了、hermes model 里那行隐藏了，全新安装会改为引导你跑 hermes setup。登录 Nous 账号、你自己的 API key 和其他 provider 一切照旧。

关于隐私有一件事值得说清楚：免费层需要一个身份来做鉴权和限流，Hermes 第一次需要时会在 Nous 门户上创建一个匿名身份，凭证存在你的 Hermes 目录里，被该目录下的所有 profile 共享。它不含邮箱、姓名或其他个人信息，连续 14 天不用会自动过期，下次命令透明地新建一个。登录会把连接器关系转移到你的账号；把 nous.guest 设为 false，则完全不会创建或使用这个身份。

常见报错对照

现象	含义	怎么办
第一条命令提示 It looks like Hermes isn't configured yet 并建议 hermes setup	免费层没能在几秒内建立：离线、门户没开免费层、或被限流	联网后重试，或直接 hermes setup 配自己的 provider。不会留下半配置状态
Nous free tier is not open on this portal.	Hermes 指向的门户当前没有免费层（例如你设过 HERMES_PORTAL_BASE_URL）	登录账号、取消门户覆盖，或加自己的 key
Nous free tier is rate limited; try again shortly.	门户正在对新免费层身份限流	等几分钟重试，或加自己的 key
This needs a Nous account.	你在免费层上调用了付费工具	聊天里 /login，终端里 hermes auth upgrade，或在 hermes tools 里给这个工具配自己的 key
模型选择器里 Nous 下只有一个 nous/welcome	免费层的正常表现	登录拿完整目录，或加别的 provider 的 key
隔了两周回来免费层不工作了	匿名身份过期，会在下次启动或下次使用时被替换	什么都不用做，重新启动 Hermes；这期间用过的连接器需要重新绑定（除非你登录过）

小结

免费层的定位很清楚：它是“先让我用起来”的通道，不是长期方案。对刚上手的人来说，它把安装到第一次成功对话之间的所有摩擦都拿掉了；对已经配好 provider 的人来说，它顺手解决了连接器的鉴权问题；等你需要更大的模型目录或联网工具，一分钟的登录就能接上。

想从零开始装一遍，看安装指南；登录相关的完整命令清单在 hermes auth 参考；模型选择和 provider 切换看 hermes model；最近的平台与模型变化可以翻发版记录。