Hermes AgentでxAIを使う
セットアップ完全ガイド

まず全体像：xAIを「標準モデル」にするか「必要な時だけ使う」か

Hermes Agentは、複数のAIプロバイダーやツールを切り替えられるエージェントです。xAI/Grokもその選択肢のひとつですが、必ずしも全作業をGrokに寄せる必要はありません。

ここを最初に分けると、設定で迷いにくくなります。普段の会話・コーディング・記事作成までGrokで動かしたいのか。それとも、X上の一次反応や投稿調査だけGrok系の検索に任せたいのか。現場では後者の方が扱いやすいことがあります。

i-Styleでは、この3つ目の発想が現実的だと見ています。普段の作業台は安定した標準モデルにして、Xの反応を見る時だけ専用の道具を取り出す。道具箱として考えると分かりやすいです。

一般的なセットアップ：APIキー方式でxAIを使う

一番イメージしやすいのは、xAIのAPIキーを発行してHermes Agentに渡す方法です。Hermes Agentのプロバイダー一覧でも、xAI/Grokの環境変数はXAI_API_KEYとして整理されています。

この方法は、アプリ連携や従量課金の管理を前提にする時に向いています。逆に、個人のGrokサブスク枠を使いたい場合は、次のOAuth方式を見た方が近いです。

# 1. Hermesの環境変数ファイルを確認
hermes config env-path

# 2. 表示された ~/.hermes/.env にAPIキーを追加
# XAI_API_KEY=ここにxAIのAPIキー

# 3. モデル選択でxAI/Grokを選ぶ
hermes model

# 4. CLIやGatewayを再起動して反映
hermes doctor

SuperGrokサブスクで使う：xAI Grok OAuth方式

Hermes AgentのxAI Grok OAuthガイドでは、SuperGrokサブスクリプションを使う場合、XAI_API_KEYなしでブラウザOAuthログインできると説明されています。Provider IDはxai-oauthです。

これが地味に大きいところです。API課金の設計から始めなくても、サブスクリプションの認証でHermes AgentにGrokをつなげられます。音声、画像、動画、文字起こしなどのdirect-to-xAI機能でも同じOAuthトークンを使える、とドキュメント上では説明されています。

# SuperGrokサブスクをHermes Agentに接続
hermes auth add xai-oauth

# 認証済みか確認
hermes auth list xai-oauth

# 必要ならモデル選択でxAI Grok OAuthを選ぶ
hermes model

注意したいのは、「認証できた」ことと「使いたい機能の利用枠がある」ことは別だという点です。最後は実際に小さな検索や生成を走らせて確認します。

i-Style式：標準はGPT-5.5、X検索だけxAIにする

i-Styleのように、記事作成・コーディング・日常のエージェント作業をGPT-5.5で統一している場合、全体の標準モデルをGrokに切り替える必要はありません。普段の作業品質や文体を変えずに、X検索だけxAIの道具として使う構成が取れます。

考え方はシンプルです。会話や執筆の「頭」はGPT-5.5。X上の反応や一次投稿を見に行く「目」だけxAI。役割を分けると、設定も運用も安定します。

# 1. まず標準モデルはOpenAI Codex OAuth / GPT-5.5にしておく
hermes model
# → OpenAI Codex / gpt-5.5 を選択

# 2. xAI OAuthを追加
hermes auth add xai-oauth

# 3. X検索ツールだけ有効化
hermes tools enable x_search

# 4. Gatewayや現在のセッションを再起動・リセットしてツール定義を反映
hermes gateway restart
# CLIなら /reset または新しいhermesセッションで確認

この分け方は、AIを「どれか1つに統一する」発想から少し離れます。実務では、標準の作業台を固定しながら、必要な時だけ専用工具を出す方が運用しやすいです。

設定できたか確認する：見る場所は3つ

セットアップでよくある落とし穴は、「設定画面では見えているけど、実際のツール呼び出しでは別の経路を使っていた」という状態です。Hermes Agentでは、認証、ツール有効化、実行テストを分けて見ます。

# 認証があるか
hermes auth list xai-oauth

# x_searchツールが有効か
hermes tools list

# 全体の診断
hermes doctor

特に最後は大事です。Xの検索結果が返ったとしても、それがxAIサブスク経由なのか、別のAPI経由なのかは分けて確認します。会社で運用するなら、ここを曖昧にしない方が後で困りません。

X検索で得た情報は「反応」であって、最終根拠ではない

X検索は、速報性や現場の反応を見るには便利です。公式発表に対してユーザーが何に驚いているか、どんな使い方が共有されているか、どの投稿が起点になっているかを探しやすいからです。

ただし、Xの投稿だけで記事や提案書の事実を確定するのは危険です。i-Styleでは、X検索は「入口」として使い、製品仕様、料金、日付、制限、公式な表現は一次ソースで確認する運用が現実的だと見ています。

AI検索が便利になるほど、人が確認する場所を決めておく価値が上がります。ここを仕組み化できる会社は、情報収集の速度だけでなく、公開前の安心感も上げられます。

よくある質問

今日やるなら、まずこれ

全部を一度に切り替える必要はありません。最初は、今の標準モデルを崩さず、X検索だけを追加する方が安全です。

AI活用は、強いモデルをひとつ選んで終わりではありません。自社の作業台に合わせて、必要な道具を必要な場所へ差し込む。Hermes AgentとxAIの連携は、その道具箱を少し広げる話として捉えると、現場に落とし込みやすくなります。