杏 杏和舒筋堂 常宁 · 群英东路51-1号

Hermes 里装 Grok,我觉得这是现在最适合普通人的一条路

很多人手里其实已经有 AI 订阅了。

有人在付 ChatGPT,有人在付 X Premium,也有人 Grok 能用,但真正干活的时候,还是开着一堆网页,来回切,像在赶场。

我最近折腾完 Hermes 之后,最大的感受不是「它多高级」,而是:终于可以把 Grok 放进一个真正像工具的桌面环境里用了。

这篇只讲一件事:怎么在 Hermes 里装好 Grok,并且开始正常使用。

不展开讲别的模型,不讲自动化,不讲复杂工作流。就讲小白最需要的两件事:怎么装,装完怎么用。

如果你是 Mac 用户,或者 Windows 用户,这篇都能直接照着走。


先说结论:为什么很多人会卡在「我明明有 Grok,却用不顺」

问题通常不在 Grok 本身。

而在于你拿着一个已经能用的订阅,却没有一个顺手的本地入口。网页版能聊,但不够像工具;直接在终端里折腾,又容易被 API key、代理、环境变量、授权流程卡住。

Hermes 刚好填了这个空。

它的价值不是把模型变强,而是把模型接入本地桌面环境。你可以在一个统一界面里处理登录、授权、模型切换和基础任务,而不是每次都从零开始折腾。(来源:[[未命名]])


先搞清楚:这篇适合谁

这篇更适合下面三种人。

第一,你已经能用 Grok,但只会在网页里用,想把它放进桌面 app 里。

第二,你不想一上来就碰一堆 API key,只想先把订阅登录跑通。

第三,你是小白,想要一套 Mac 和 Windows 都能照抄的安装方法。

如果你现在追求的是自动化、多模型编排、复杂技能系统,那不是这篇重点。

这篇先帮你把最基础的一步走通:Hermes 里把 Grok 接上,能正常跑起来。


第一步:认准官方入口,不要下错地方

先别急着搜教程,先认官网。

Hermes 的官方入口是:

https://hermes-agent.nousresearch.com/

桌面端文档页是:

https://hermes-agent.nousresearch.com/docs/user-guide/desktop

安装总文档是:

https://hermes-agent.nousresearch.com/docs/getting-started/installation

这一点很重要。

因为你在网上搜「Hermes desktop」的时候,很容易看到各种第三方仓库、教程转述,甚至命令都混在一起。最稳的原则只有一个:下载桌面端、抄安装命令,都只认官方站和官方文档。(来源:[[未命名]])


第二步:Windows 和 Mac 怎么装

这里分两条路。

一条是桌面端安装,适合大多数普通用户。

另一条是命令行安装,适合你想直接装 Hermes runtime,或者后面还要继续走 CLI。

Windows 安装方法

如果你是 Windows 用户,最推荐还是先装 Hermes Desktop。

官方桌面端入口:https://hermes-agent.nousresearch.com/

官方 Windows 指南:https://hermes-agent.nousresearch.com/docs/user-guide/windows-native

如果你更想直接走命令行,官方 PowerShell 安装命令是:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

装完之后,如果你是桌面端路线,就直接打开 Hermes Desktop。

如果你是命令行路线,可以继续检查 Hermes 有没有装成功。

Mac 安装方法

如果你是 Mac 用户,同样优先建议先用 Hermes Desktop。

官方入口还是这个:https://hermes-agent.nousresearch.com/

如果你更习惯命令行,官方 shell 安装命令是:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

这条命令适用于 macOS,也适用于 Linux。(来源:[[未命名]])

装完先检查什么

不管你是 Windows 还是 Mac,装完以后先不要急着接 Grok。

先确认两件事。

第一,Hermes Desktop 能不能正常打开。

第二,如果你走的是命令行安装,终端里能不能识别 hermes 命令。

可以先跑:

hermes --version

如果这一步就报错,那先别怪 Grok,也别怪订阅。先回头查安装本身。


第三步:如果桌面端装不上,先查这几个高频坑

这里我觉得是最有必要提前说清楚的。

因为很多人不是卡在 Grok,而是卡在 Hermes 根本没装起来。

素材里提到的几个坑,其实都很典型。

1. Git 没装

Windows 上这是高频问题。

如果 Hermes 启动失败,或者某些安装步骤一直过不去,先确认 Git 在不在。

可以直接装:

winget install Git.Git

装完以后重启终端,或者干脆重启电脑再试。(来源:[[未命名]])

2. 杀毒软件拦截

这一点很多小白想不到,但很常见。

像火绒、Windows 安全中心这类软件,有时会把 Hermes 某些行为拦掉。你自己看到的表象可能只是「装不上」「打不开」「一闪而退」。

如果你确认安装包来源没问题,但程序就是起不来,就去看安全软件有没有拦。必要时把 Hermes 文件夹加入信任或排除列表。(来源:[[未命名]])

3. 旧残留没清干净

很多人第一次装失败,第二次还是直接覆盖装。

这时候问题不一定会消失,反而可能把残留错误一起带着跑。

更稳的做法是:旧文件夹尽量清理干净,再重装。

4. 依赖下载一直失败

这类问题常常不是软件坏了,而是网络环境有问题。

如果你已经连安装都过不去,优先去看网络和代理,不要一上来就在各种设置里乱改。


第四步:开始接 Grok,不走 API key 先走订阅登录

Hermes 里接 Grok,最关键的是先分清两条路。

一条是 API key。

另一条是 OAuth 订阅登录。

如果你现在的目标只是「我已经有 Grok / xAI 订阅,我想直接用它」,那你优先走 OAuth 这条路。

官方 xAI Grok OAuth 文档在这里:

https://hermes-agent.nousresearch.com/docs/guides/xai-grok-oauth

最基础的登录命令是:

hermes auth add xai-oauth

如果你当前环境不方便自动拉浏览器,也可以用:

hermes auth add xai-oauth --no-browser

这条命令的作用,是让 Hermes 走 xAI 的 OAuth 流程,把你的 Grok 订阅账号接进来,而不是逼你先去申请 API key。(来源:[[未命名]])


第五步:如果 Grok 订阅还是连不上,重点查代理设置

这一段是最容易把人折磨崩溃的地方。

因为你会看到一种很烦的情况:浏览器能开相关网页,但 Hermes 这边就是超时,死活过不去。

不是没开代理,而是系统里存在一个「某些域名不要走代理」的设置,刚好把和 xAI 相关的地址排除了。

结果就是:浏览器看起来能开,但程序访问真正的接口时在走直连,而你这边直连根本不通,所以它一直超时。(来源:[[未命名]])

Windows 用户重点看 NO_PROXY

如果你本机已经开了代理,比如常见的 127.0.0.1:7890 这种本地代理,那就要去检查环境变量里的 NO_PROXY。

如果里面有和 xAI、Grok 相关的域名,比如 .x.ai 或 .grok.com,先删掉。

更稳的写法可以保留成:

localhost,127.0.0.1

改完以后,不是原窗口继续试,而是把旧终端关掉,再新开一个终端再跑。

Mac 用户也一样要查

Mac 虽然不是同一个界面,但逻辑一样。

只要你本机有代理,Hermes 又要走 OAuth 接 xAI,你就得确认系统或 shell 环境里没有把相关域名排除出代理链路。

很多人不是不会装,而是卡在这种非常偏、但又很致命的设置上。


第六步:Grok 登录完成后,怎么确认自己真的接上了

连完以后,不要只看「好像成功了」。

最好做两个动作确认。

1. 先看认证有没有存上

可以跑:

hermes auth list xai-oauth

如果这里能看到对应认证信息,说明至少 OAuth 这一步是落下来了。

2. 再去选模型

你可以用:

hermes model

或者如果你已经进了 Hermes 会话界面,也可以直接用 /model 来切模型。

到这里,如果你已经能选到 Grok,对话也能正常返回内容,就说明这条链路真的通了。(来源:[[未命名]])


第七步:装好以后,最基础怎么用

这一段不讲高级技巧,就讲最基础的用法。

如果你已经把 Hermes 和 Grok 接好了,最简单的开始方式就是两种。

第一种,直接进入 Hermes 会话界面,选 Grok 当当前模型,然后开始提问。

第二种,先让它做一件非常小的事,不要一上来就丢大任务。

比如:

「帮我查一下这个 X 账号最近在聊什么。」

或者:

「帮我总结这段内容的核心观点。」

或者:

「帮我把这段中文改成更适合发 X 的版本。」

重点不是一开始就证明它多强,而是先确认三件事:

它是不是已经在用 Grok;它是不是能稳定返回结果;你是不是已经知道怎么切模型、怎么继续对话。

如果这三件事顺了,再往后加别的模型、别的工作流都不迟。


第八步:如果你还想一起接 ChatGPT

这个可以作为顺手补充。

如果你后面还想把 ChatGPT 也一起挂进 Hermes,素材里提到的路径是:

hermes auth add openai-codex

这更适合已经有 ChatGPT 订阅、并且想把写代码这件事一起放进 Hermes 里的人。

但这不是这篇主线。

这篇的重点始终只有一个:先把 Grok 接通,而且尽量走订阅登录,不从 API key 开始把自己吓退。


最后,把整套流程压成最短版本

如果你只记五步,记这五步就够了。

第一,只认 Hermes 官方网站和官方文档下载。

第二,Windows 用:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Mac 用:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

第三,先确认 hermes --version 正常,再去接 Grok。

第四,优先用:

hermes auth add xai-oauth

如果需要手动授权就用:

hermes auth add xai-oauth --no-browser

第五,如果一直超时,重点查代理和 NO_PROXY,尤其是 .x.ai、.grok.com 这类域名有没有被错误排除。

这五步顺了,大概率你就能把 Hermes 里的 Grok 用起来。

很多人卡了很久,不是因为不会用 AI,而是因为第一条本地链路没跑通。

跑通这一次,后面就顺很多。