免 API Key 白嫖 Grok-4.3，X Premium 订阅接入 Hermes Agent「完整教程」
本文适合已有 X Premium 订阅、想把 Grok 接入 Hermes Agent 的人。
不需要 XAI_API_KEY，走订阅配额，分本地和服务器两种情况说明。
1- 📋 前置条件
- 已安装 Hermes Agent
- 一个有效的 X Premium 订阅（任意等级均可，X Premium 和 X Premium+ 都行）
- 能正常访问 accounts.x.ai
- 没安装的看我这篇教程
4月8日
2- 🖥 情况一：本地安装 Hermes（直接操作）
本地有浏览器，官方推荐用 hermes model 一步完成授权 + 选模型：
hermes model
在列表里选 xAI Grok OAuth (SuperGrok Subscription)，Hermes 自动打开浏览器跳转 accounts.x.ai，授权完回来再选模型（grok-4.3 置顶），然后直接 hermes 开聊。
如果只想单独做授权、不选模型，也可以用：
hermes auth add xai-oauth
两个都是官方推荐，hermes model 更省步骤。完成后直接跳到验证步骤。
3- 🌐 情况二：服务器安装 Hermes（需要端口转发）
服务器上没有浏览器，OAuth 的回调监听在服务器本地（127.0.0.1:56121），但授权要在你本地浏览器完成。
需要先用 SSH 端口转发把这两端打通，再触发授权。
第一步： 本地新开一个终端，运行端口转发
ssh -N -L 56121:127.0.0.1:56121 -p YOUR_PORT user@your-server-ip
-N 表示只做转发不执行命令，这个终端保持开着不要关，授权完成后再关。
第二步： 在服务器 SSH 会话里触发登录
hermes auth add xai-oauth --no-browser
--no-browser 让 Hermes 打印授权 URL 而不是尝试打开浏览器。
运行后终端会显示：
Waiting for callback on http://127.0.0.1:56121/callback
Remote session detected. Your browser will redirect to
http://127.0.0.1:56121/callback
...
同时打印出一条 https://accounts.x.ai/oauth/authorize?... 开头的授权链接。
第三步： 复制链接，在本地浏览器打开授权
粘贴到本地浏览器，用 X 账号登录并允许授权。
授权完成后 callback 会通过 SSH 隧道自动回传到服务器，服务器终端显示：
Added xai-oauth OAuth credential #1: "xai-oauth-oauth-1"
看到这一行说明授权成功，token 已保存，以后自动续期。
🚨 授权有 180 秒超时，复制链接后尽快操作。超时了重新运行第二步命令即可。
4- ✅ 验证登录状态
两种情况都做完后，运行：
hermes doctor
在 ◆ Auth Providers 部分确认 xai-oauth 状态正常即可。
5- 🚀 开启 X 搜索和视频生成
5月17日
傻逼了 看了官方文档：X/Twitter 搜索（默认关闭，需手动开启）。
手动开启后，Hermes 结合 grok-4.3 直接可以搜索推文了。
开启方式如下：
- hermes tools
- 选一个进入设置，例如CLI
- 将 X (Twitter) Search 开启
- 重启会话，搞定！
这步容易踩坑，我TM就掉坑里了，傻逼了😄。
X 搜索和视频生成登录后默认都是关闭状态，需要手动进工具菜单启用。
hermes tools
找到对应工具，按空格启用：
X 搜索配置完走的是 SuperGrok 订阅配额，不消耗 API 额度，如果同时配了 API Key 也优先用 OAuth。
视频生成支持文字转视频和图片转视频，最多可以传 7 张参考图。
6- ❓ 常见问题
Q：授权超时了怎么办？
本地重新运行 hermes auth add xai-oauth，服务器重新运行 hermes auth add xai-oauth --no-browser，180 秒重新计时。
Q：授权页面显示"Could not establish connection"？
端口转发没生效。检查第一步的转发终端是否还在运行，确认 IP 和 SSH 端口填对了。
Q：X 搜索还是要 API Key？
进 hermes tools 确认两件事：一是 X Search 已按空格启用，二是后端选的是 xAI OAuth，两个都要。
Q：Token 过期了怎么重新登录？
hermes auth add xai-oauth
报 invalid_grant 也是同一个命令，重新走授权流程。
Q：报"No xAI credentials found"怎么办？
说明还没登录，或者 ~/.hermes/auth.json 里的凭据被删了。重新走一遍 hermes model 或 hermes auth add xai-oauth 即可。
Q：登录时报 state mismatch？
Hermes 检测到授权回调的 state 值对不上，可能是中间有代理或重定向改了响应。
重新运行登录命令，一般就好了，如果反复出现检查网络环境里有没有代理在拦截。
Q：怎么退出登录？
hermes auth logout xai-oauth
会清除 auth.json 里的所有 xai-oauth 凭据。
Q：用量有限制吗？ 🔥
走的是 SuperGrok 订阅配额，不消耗 API 余额。触到限额等重置周期就好，X 搜索也优先用 OAuth 配额。