如果你已经在用 SuperGrok 或 X Premium+，但还在 Hermes 里单独折腾 API Key、图像工具、视频工具、X 搜索工具，那这篇可以直接省掉你半天试错。

Grok 接入 Hermes 最舒服的方式，是走 xAI OAuth。

你**只需要完成一次账号授权，**Hermes 就可以同时拿到聊天模型、图像生成、视频生成、语音合成、语音转写和实时 X 搜索能力。

后面换模型、开工具、做 Agent 自动化，都不用再反复管理一堆 Key。

这篇按真实使用路径写：先接入，再开工具，再验证，最后处理常见坑。

你真正要接入的是什么

很多人第一次看 Hermes 的 Grok 选项，会以为它只是“多加一个聊天模型”。

实际更准确的理解是：

你是在 Hermes 里接入一整套 xAI 账号能力。

xAI Grok OAuth (SuperGrok / X Premium+) 这一路径支持通过 xAI 账号授权使用 Grok 模型，

并且可以让 Hermes 的相关工具直接复用同一套 OAuth 凭证，包括 TTS、图像、视频、转写和 X 搜索能力。官方文档见：xAI Grok OAuth Guide。

这就是它最值得用的地方：

  • 你不用单独配置 XAI_API_KEY
  • 你不用为每个工具重复登录
  • 你可以让 Hermes 在 Agent 工作流里直接调用 Grok 的多模态能力
  • 你可以用同一个订阅额度覆盖聊天和工具调用
    如果你只是偶尔问两句话，普通网页端 Grok 就够了。

但如果你想让 Hermes 帮你边搜 X、边写稿、边生成图、边做语音或视频，OAuth 方式明显更顺手。

开始前先确认三件事

接入前，先确认你手里有这几个条件：

  1. 已经安装 Hermes Agent，建议使用最新版
  2. 你有 SuperGrok 或 X Premium+ 订阅
  3. 浏览器可以正常打开 accounts.x.ai
    如果你是在云服务器、VPS、SSH 远程机器上安装 Hermes，也没问题。后面有专门的远程授权流程。

第一步：用 hermes model 添加 Grok OAuth

最推荐的方式是从模型选择器进入：

在列表中找到并选择：

Hermes 会自动打开浏览器，进入 accounts.x.ai 的设备码授权流程。

你会看到一个验证页面和一串设备码。按提示登录你的 xAI 账号并完成授权。授权成功后，回到终端，Hermes 会自动保存 OAuth token。

完成后，Hermes 会把凭证写入本地配置，一般位于：

后续 token 会自动刷新，你通常不用手动维护。

授权成功后，grok-build-0.1 或当前可用的 Grok 模型会出现在 Hermes 的模型列表里。

Hermes 官方文档也提到，OAuth 路径的默认模型是 grok-build-0.1；如果后续 xAI 或 Hermes 调整模型名，以你本机 hermes model 里显示的为准。

这里有一个小细节：

终端里切换或添加模型，用的是：

已经进入聊天会话后，临时切换模型，用的是：

一个在会话外，一个在会话内。很多人卡住，其实只是命令场景用错了。

云服务器和 SSH 远程安装怎么授权

如果 Hermes 装在远程服务器上，浏览器不会自动弹出来，这时用手动设备码流程：

Hermes 会在终端打印一个 URL 和设备码。

你要做的是：

  1. 在自己本地电脑浏览器打开终端里显示的 URL
  2. 输入设备码
  3. 登录 xAI 账号并授权
  4. 回到服务器终端等待 Hermes 确认授权完成
    这里特别提醒一下：设备码授权不需要本地回调地址，所以通常不需要 SSH 本地端口转发。除非你的服务器连 xAI 授权服务都访问不了，否则优先按 –no-browser 流程走，最省事。

授权完成后，建议立刻检查一次：

也可以查看认证状态：

如果 xai-oauth 显示已连接，第一步就完成了。

第二步：打开 Grok 专属工具

很多人以为模型能聊天，工具就自动全开了。实际使用中，建议你手动进工具列表确认一遍：

在工具列表里找到并启用这些项目：

其中最容易漏掉的是视频生成。

Hermes 官方文档明确提到，视频生成默认关闭，需要你在 hermes tools 里手动开启。

X 搜索稍微特殊一点。根据 Hermes 的 X Search 文档，只要检测到 xAI OAuth 或 API Key 凭证，x_search 工具通常会自动启用。

但我仍然建议你进 hermes tools 看一眼。因为真实环境里，工具注册表、会话缓存、旧配置都可能让你以为“已经开了”，结果新会话里找不到。

保存工具配置后，重启 Hermes 或在会话中执行：

新会话会加载最新工具状态。

第三步：做一组最小验证

接入完成后，不要急着跑复杂 Agent。先做最小验证。

测试聊天：

测试 X 搜索：

测试图像生成：

测试语音合成：

测试视频生成：

如果聊天、X 搜索、图像、语音、视频都能正常调用，说明这套链路基本接通了。

常见问题：为什么我授权了还是不能用

1. xai-oauth 显示成功，但模型不可用

先运行：

再进入：

确认当前模型确实切到了 Grok OAuth 提供方。

如果你还在会话里，也可以输入：

检查当前会话是不是仍在使用旧模型。

2. 工具列表里没有图像、视频或 X 搜索

先确认凭证状态：

再重新打开工具列表：

保存后重启 Hermes，或者在会话里执行：

如果你是从旧版本升级上来的，也建议升级 Hermes 后再试一次。工具注册和模型提供方能力在 2026 年仍在快速变化，版本差异会直接影响体验。

3. 出现 HTTP 403

这通常不是命令输错，而是账号权限或 xAI 后台授权范围问题。

部分标准 SuperGrok 账号可能会因为 xAI 权限或 allowlist 问题遇到 HTTP 403。遇到这种情况，可以先确认你的订阅状态，再尝试重新授权。

重新授权命令：

如果 OAuth 路径一直 403，也可以临时改用 API Key 路径：

选择 xAI API Key 相关提供方，并配置：

不过从日常使用成本和维护便利性看，能用 OAuth 的情况下，优先用 OAuth。

4. 老模型名失效或迁移失败

Hermes 官方 provider 文档提到，xAI 旧模型在 2026 年 5 月 15 日前后有过迁移变化。

如果你很早就配置过 xAI，建议检查迁移：

确认没问题后再应用：

迁移后重新进入：

选择当前可用的 Grok OAuth 模型。

常用命令速查

最后给你一个实用判断

如果你只是想在 Hermes 里偶尔调用 Grok 聊天，API Key 也能用。

但如果你已经有 SuperGrok 或 X Premium+，并且希望 Hermes 具备完整 Agent 能力，那 OAuth 是更省心的路线。

一次登录后，你可以把 Grok 当成 Hermes 的多模态能力底座：

  • 写作时，让它实时搜 X 找素材
  • 做内容时，让它顺手生成封面图
  • 做自动化时，让它补视频和语音
  • 做研究时，让它把 X 搜索结果纳入上下文
    这才是 Grok 接入 Hermes 的真正价值。

它不只是多一个模型入口，而是把你的 SuperGrok / X Premium+ 订阅变成 Hermes 里的一个完整工具层。

先跑通 OAuth，再打开工具，再做最小验证。按这个顺序走，基本能避开 90% 的坑。

来源：@JackQi82772 · 发布于 2026-07-13 10:41:03 · 原文链接