#Grok 接入 Hermes 完整攻略：一次 OAuth，解锁聊天、生图、视频、语音与 X 搜索（2026 最新版）
如果你已经在用 SuperGrok 或 X Premium+，但还在 Hermes 里单独折腾 API Key、图像工具、视频工具、X 搜索工具，那这篇可以直接省掉你半天试错。
Grok 接入 Hermes 最舒服的方式，是走 xAI OAuth。
你只需要完成一次账号授权，Hermes 就可以同时拿到聊天模型、图像生成、视频生成、语音合成、语音转写和实时 X 搜索能力。后面换模型、开工具、做 Agent 自动化，都不用再反复管理一堆 Key。
这篇按真实使用路径写：先接入，再开工具，再验证，最后处理常见坑。
#你真正要接入的是什么
很多人第一次看 Hermes 的 Grok 选项，会以为它只是“多加一个聊天模型”。
实际更准确的理解是：
你是在 Hermes 里接入一整套 xAI 账号能力。
按 Hermes 官方文档的说法，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 方式明显更顺手。
#开始前先确认三件事
接入前，先确认你手里有这几个条件：
- 已经安装 Hermes Agent，建议使用最新版
- 你有 SuperGrok 或 X Premium+ 订阅
- 浏览器可以正常打开
accounts.x.ai
如果你是在云服务器、VPS、SSH 远程机器上安装 Hermes，也没问题。后面有专门的远程授权流程。
#第一步：用 hermes model 添加 Grok OAuth
最推荐的方式是从模型选择器进入：
hermes model在列表中找到并选择：
xAI Grok OAuth (SuperGrok / X Premium+)Hermes 会自动打开浏览器，进入 accounts.x.ai 的设备码授权流程。
你会看到一个验证页面和一串设备码。按提示登录你的 xAI 账号并完成授权。授权成功后，回到终端，Hermes 会自动保存 OAuth token。
完成后，Hermes 会把凭证写入本地配置，一般位于：
~/.hermes/auth.json后续 token 会自动刷新，你通常不用手动维护。
授权成功后，grok-build-0.1 或当前可用的 Grok 模型会出现在 Hermes 的模型列表里。Hermes 官方文档也提到，OAuth 路径的默认模型是 grok-build-0.1；如果后续 xAI 或 Hermes 调整模型名，以你本机 hermes model 里显示的为准。
这里有一个小细节：
终端里切换或添加模型，用的是：
hermes model已经进入聊天会话后，临时切换模型，用的是：
/model一个在会话外，一个在会话内。很多人卡住，其实只是命令场景用错了。
#云服务器和 SSH 远程安装怎么授权
如果 Hermes 装在远程服务器上，浏览器不会自动弹出来，这时用手动设备码流程：
hermes auth add xai-oauth --no-browserHermes 会在终端打印一个 URL 和设备码。
你要做的是：
- 在自己本地电脑浏览器打开终端里显示的 URL
- 输入设备码
- 登录 xAI 账号并授权
- 回到服务器终端等待 Hermes 确认授权完成
这里特别提醒一下：设备码授权不需要本地回调地址，所以通常不需要 SSH 本地端口转发。除非你的服务器连 xAI 授权服务都访问不了，否则优先按 --no-browser 流程走，最省事。
授权完成后，建议立刻检查一次：
hermes doctor也可以查看认证状态：
hermes auth status如果 xai-oauth 显示已连接，第一步就完成了。
#第二步：打开 Grok 专属工具
很多人以为模型能聊天，工具就自动全开了。实际使用中，建议你手动进工具列表确认一遍：
hermes tools在工具列表里找到并启用这些项目：
Text-to-Speech → xAI TTS
Image Generation → xAI Grok Imagine (image)
Video Generation → xAI Grok Imagine
X (Twitter) Search → xAI Grok OAuth (SuperGrok / X Premium+)其中最容易漏掉的是视频生成。
Hermes 官方文档明确提到，视频生成默认关闭，需要你在 hermes tools 里手动开启。
X 搜索稍微特殊一点。根据 Hermes 的 X Search 文档，只要检测到 xAI OAuth 或 API Key 凭证，x_search 工具通常会自动启用。官方说明见：Hermes X Search。
但我仍然建议你进 hermes tools 看一眼。因为真实环境里，工具注册表、会话缓存、旧配置都可能让你以为“已经开了”，结果新会话里找不到。
保存工具配置后，重启 Hermes 或在会话中执行：
/reset新会话会加载最新工具状态。
#第三步：做一组最小验证
接入完成后，不要急着跑复杂 Agent。先做最小验证。
测试聊天：
hermes chat -q "你好，用中文回复，并告诉我你当前使用的模型。"测试 X 搜索：
请使用 x_search 搜索最近 24 小时内关于 Hermes Agent Grok OAuth 的讨论，并总结 5 条要点。测试图像生成：
请用 image_generate 生成一张 16:9 封面图：黑白极简风，一个终端窗口连接到 Grok OAuth，中文标题「一次登录，解锁 Grok 全能力」。测试语音合成：
请用 xAI TTS 把这句话合成为中文语音：Grok 已成功接入 Hermes。测试视频生成：
请用 xAI Grok Imagine 生成一个 5 秒短视频：终端命令启动后，多个工具图标被点亮。如果聊天、X 搜索、图像、语音、视频都能正常调用，说明这套链路基本接通了。
#常见问题：为什么我授权了还是不能用
1. xai-oauth 显示成功，但模型不可用
先运行：
hermes doctor再进入：
hermes model确认当前模型确实切到了 Grok OAuth 提供方。
如果你还在会话里，也可以输入：
/model检查当前会话是不是仍在使用旧模型。
2. 工具列表里没有图像、视频或 X 搜索
先确认凭证状态：
hermes auth status再重新打开工具列表：
hermes tools保存后重启 Hermes，或者在会话里执行：
/reset如果你是从旧版本升级上来的，也建议升级 Hermes 后再试一次。工具注册和模型提供方能力在 2026 年仍在快速变化，版本差异会直接影响体验。
3. 出现 HTTP 403
这通常不是命令输错，而是账号权限或 xAI 后台授权范围问题。
Hermes 官方文档提到，部分标准 SuperGrok 账号可能会因为 xAI 权限或 allowlist 问题遇到 HTTP 403。遇到这种情况，可以先确认你的订阅状态，再尝试重新授权。
重新授权命令：
hermes auth logout xai-oauth
hermes auth add xai-oauth如果 OAuth 路径一直 403，也可以临时改用 API Key 路径：
hermes model选择 xAI API Key 相关提供方，并配置：
XAI_API_KEY不过从日常使用成本和维护便利性看，能用 OAuth 的情况下，优先用 OAuth。
4. 老模型名失效或迁移失败
Hermes 官方 provider 文档提到，xAI 旧模型在 2026 年 5 月 15 日前后有过迁移变化。官方 provider 文档见：Hermes Providers。
如果你很早就配置过 xAI，建议检查迁移：
hermes migrate xai确认没问题后再应用：
hermes migrate xai --apply迁移后重新进入：
hermes model选择当前可用的 Grok OAuth 模型。
#常用命令速查
| 需求 | 命令 | 说明 |
| --- | --- | --- |
| 添加或切换模型 | hermes model | 推荐入口 |
| 会话内切换模型 | /model | 进入 Hermes 聊天后使用 |
| 手动添加 Grok OAuth | hermes auth add xai-oauth | 重新登录或补充认证 |
| 远程服务器授权 | hermes auth add xai-oauth --no-browser | SSH / VPS 常用 |
| 查看认证状态 | hermes auth status | 检查是否已登录 |
| 查看健康状态 | hermes doctor | 检查 OAuth 和环境 |
| 开启工具 | hermes tools | 启用图像、视频、TTS、X 搜索 |
| 测试聊天 | hermes chat -q "你好，用中文回复" | 快速验证模型 |
| 查看使用情况 | hermes insights | CLI 查看使用数据 |
| 退出登录 | hermes auth logout xai-oauth | 清除凭证 |
| 检查旧模型迁移 | hermes migrate xai | 旧配置用户建议执行 |
| 应用旧模型迁移 | hermes migrate xai --apply | 确认后再运行 |
#最后给你一个实用判断
如果你只是想在 Hermes 里偶尔调用 Grok 聊天，API Key 也能用。
但如果你已经有 SuperGrok 或 X Premium+，并且希望 Hermes 具备完整 Agent 能力，那 OAuth 是更省心的路线。
一次登录后，你可以把 Grok 当成 Hermes 的多模态能力底座：
- 写作时，让它实时搜 X 找素材
- 做内容时，让它顺手生成封面图
- 做自动化时，让它补视频和语音
- 做研究时，让它把 X 搜索结果纳入上下文
这才是 Grok 接入 Hermes 的真正价值。
它不只是多一个模型入口，而是把你的 SuperGrok / X Premium+ 订阅变成 Hermes 里的一个完整工具层。
先跑通 OAuth，再打开工具，再做最小验证。按这个顺序走，基本能避开 90% 的坑。