TimeAmber![](data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" width="73" height="73"><rect fill-opacity="0"/></svg>)
Hermes Agent 不完全指南：从入门到放弃「新手友好」本文适合完全没有命令行经验的新手，也适合从 OpenClaw 迁移过来的用户。手把手带你从零开始，装好 Hermes Agent，接入 Telegram，并了解它的核心玩法。
它是什么
Nous Research 今年 2 月底开源的 AI Agent...
它是什么
Nous Research 今年 2 月底开源的 AI Agent... Hermes Agent 不完全指南：从入门到放弃「新手友好」
免 API Key 白嫖 Grok-4.3，X Premium 订阅接入 Hermes Agent「完整教程」本文适合已有 X Premium 订阅、想把 Grok 接入 Hermes Agent 的人。
不需要 XAI_API_KEY，走订阅配额，分本地和服务器两种情况说明。
📋 前置条件
- 已安装 Hermes Agent
- 一个有效的 X Premium 订阅（任意等级均可，X Premium 和 X Premium+ 都行）
- 能正常访问
- 没安装的看我这篇教程
Hermes Agent 不完全指南：从入门到放弃「新手友好」🖥 情况一：本地安装 Hermes（直接操作）
本地有浏览器，官方推荐用 hermes model 一步完成授权 + 选模型：
hermes model在列表里选 xAI Grok OAuth (SuperGrok Subscription)，Hermes 自动打开浏览器跳转 ，授权完回来再选模型（grok-4.3 置顶），然后直接 hermes 开聊。
如果只想单独做授权、不选模型，也可以用：
hermes auth add xai-oauth两个都是官方推荐，hermes model 更省步骤。完成后直接跳到验证步骤。
🌐 情况二：服务器安装 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
...第三步：复制链接，在本地浏览器打开授权
粘贴到本地浏览器，用 X 账号登录并允许授权。授权完成后 callback 会通过 SSH 隧道自动回传到服务器，服务器终端显示：
Added xai-oauth OAuth credential #1: "xai-oauth-oauth-1"看到这一行说明授权成功，token 已保存，以后自动续期。
🚨 授权有 180 秒超时，复制链接后尽快操作。超时了重新运行第二步命令即可。
✅ 验证登录状态
两种情况都做完后，运行：
hermes doctor在 ◆ Auth Providers 部分确认 xai-oauth 状态正常即可。
🚀 开启 X 搜索和视频生成
傻逼了
看了官方文档：X/Twitter 搜索（默认关闭，需手动开启）
手动开启后，Hermes 结合 grok-4.3 直接可以搜索推文了
开启方式如下：
1. hermes tools
2. 选一个进入设置，例如CLI
3. 将 X (Twitter) Search 开启
4. 重启会话，搞定！
看了官方文档：X/Twitter 搜索（默认关闭，需手动开启）
手动开启后，Hermes 结合 grok-4.3 直接可以搜索推文了
开启方式如下：
1. hermes tools
2. 选一个进入设置，例如CLI
3. 将 X (Twitter) Search 开启
4. 重启会话，搞定！
引用
Lonely
@Lonely__MH
「薅羊毛福利」也算是羊毛了吧，这下把 蓝V 的价值直接榨干！
Hermer 接入 X Premium 步骤如下：
1. hermes update
2. hermes model
3. 选择- (●) xAI Grok OAuth (SuperGrok Subscription)
4. 点击出现的URL ,点击授权
5. 选择 模型 exp: grok-4.3
6. 完成
实测，抓取推文需要提前配置 X API x.com/Lonely__MH/sta…这步容易踩坑，我TM就掉坑里了，傻逼了😄。
X 搜索和视频生成登录后默认都是关闭状态，需要手动进工具菜单启用。
hermes tools
爱马仕工具
爱马仕工具
找到对应工具，按空格启用：
X 搜索配置完走的是 SuperGrok 订阅配额，不消耗 API 额度，如果同时配了 API Key 也优先用 OAuth。视频生成支持文字转视频和图片转视频，最多可以传 7 张参考图。
❓ 常见问题
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 配额。
📚 历史文章汇总
想发布自己的文章？
升级为 Premium
