之前在 VPS 上运行 Hermes Agent，一直想把自己的 SuperGrok 订阅也接进来。这样不用单独填写 XAI_API_KEY，Hermes 就能通过 xAI OAuth 调用 Grok 模型。
实际配置比我原来想的简单。即使 Hermes 跑在没有桌面的远程服务器上，也不需要安装浏览器，更不用专门搭 SSH 回调隧道。
这条 OAuth 通道解决什么问题
Hermes 支持两种连接 xAI 的常见方式：
- 使用
XAI_API_KEY，按 xAI API 的计费和权限调用； - 使用
xai-oauth，登录已有的 SuperGrok 或关联了 X Premium+ 的账号。
我这次使用的是第二种。它走 xAI 的 OAuth 2.0 设备代码流程，认证服务器是 accounts.x.ai。登录成功后，凭据会保存在 Hermes 的认证存储中，并在后续使用时自动刷新，不需要每次重新登录。
在 VPS 上开始登录
通过 SSH 登录运行 Hermes 的服务器，在终端执行：
hermes auth add xai-oauth --no-browser--no-browser 的意思是：不要尝试在 VPS 上打开浏览器，而是把验证网址和代码打印在终端里。
接下来按照终端提示操作：
- 复制 Hermes 给出的验证网址；
- 在自己电脑或手机的浏览器中打开；
- 登录拥有 SuperGrok 或 X Premium+ 权益的账号；
- 根据页面提示输入设备代码并批准访问；
- 回到 VPS 终端，等待 Hermes 完成认证。
我这次实际操作时，浏览器登录后还得到了一段字符串，需要复制回终端。不同版本的 Hermes 和 xAI 登录页面，交互细节可能略有变化：有的会让 Hermes 在后台自动轮询，有的会提示手工粘贴返回内容。照着终端当时显示的提示做就可以，不要把这段代码或字符串发给别人。
为什么不需要 SSH 端口转发
很多 OAuth 登录会把浏览器重定向到 127.0.0.1，如果程序运行在 VPS、浏览器却在本地电脑，就需要 SSH 隧道把回调端口转发过去。
xAI Grok OAuth 不是这种回环回调，而是设备代码流程。Hermes 在服务器上申请设备代码，我们在任意浏览器中登录并批准，Hermes 再从服务器持续查询授权结果。因此，VPS 不需要开放额外端口，也不需要设置本地回调监听器。
检查是否登录成功
认证完成后，可以运行：
hermes doctor在 Auth Providers 部分检查 xai-oauth 的状态。也可以查看已保存的 xAI OAuth 凭据：
hermes auth list xai-oauth这里只需要确认状态和条目是否存在，不要把 token 或认证文件内容复制到聊天、截图或公开文章中。
切换到 Grok 模型
最省事的方式是打开模型选择器：
hermes model在 Provider 列表中选择 xAI Grok OAuth (SuperGrok / X Premium+)，再选择当前可用的 Grok 模型。
也可以直接设置默认 Provider 和模型。模型名称会随 xAI 和 Hermes 的目录更新而变化，下面使用官方文档当前列出的默认模型：
hermes config set model.provider xai-oauth
hermes config set model.default grok-build-0.1如果 Hermes 还运行在 Telegram、飞书等 Gateway 会话里，修改默认模型后最好重新启动 Gateway 或新建会话，让新的 Provider 配置完整生效：
hermes gateway restart一次登录还能用于哪些 xAI 功能
按照 Hermes 当前文档，同一个 xAI OAuth token 还可以被直连 xAI 的工具复用，包括：
- xAI TTS；
- Grok Imagine 图片生成；
- Grok Imagine 视频生成；
- 音频转录；
- X 搜索。
这些工具需要在 hermes tools 中选择对应的 xAI 后端。视频生成默认关闭，需要时再启用。配置 xAI 凭据后，X 搜索工具可能自动启用；如果不需要，可以在工具设置中关闭。
几个容易踩的坑
1. 浏览器登录成功，但模型调用返回 403
登录成功只说明 OAuth token 已经拿到，不一定代表当前订阅套餐拥有 OAuth API 调用权限。Hermes 官方文档提醒，xAI 后端可能按套餐或白名单限制 OAuth API；部分账号即使应用内订阅正常，也可能在推理时收到 403。
这种情况反复登录通常没有用。可以改用 XAI_API_KEY，并把 Provider 切换为 xai：
hermes config set model.provider xai2. 授权页面超时
设备代码有有效期。如果打开网址后放置太久，Hermes 会提示授权超时。重新执行登录命令，生成新的网址和代码即可。
3. Token 被撤销或刷新失败
如果账号轮换、授权被撤销，或者刷新 token 返回 invalid_grant，重新运行：
hermes auth add xai-oauth需要彻底退出并清除本地 xAI OAuth 凭据时，可以执行：
hermes auth logout xai-oauth我的使用感受
在远程 VPS 上配置 OAuth，最容易让人担心的是“服务器没有浏览器怎么办”和“本地浏览器怎样回调到远程机器”。xAI 采用设备代码流程后，这两个问题都不存在：服务器负责发起和轮询，本地浏览器只负责登录批准。
整个过程就是一条命令、一个网址和一次账号确认。配置成功后，Hermes 可以把 Grok 当成普通 Provider 使用，订阅账号也能和日常的 Agent 工作流接起来。对已经购买 SuperGrok 或 X Premium+、又把 Hermes 长期放在 VPS 上运行的人来说，这种方式比较顺手。
参考资料
