# Grok xAI OAuth × Hermes x_search 認証完了記録

> 2026-05-25 shadow で認証完了・動作確認済み

## 認証状態

| credential | 状態 |
|-----------|------|
| xai-oauth-2 | ✅ logged in (juyoda アカウント) |
| xai-oauth-qawasa | ✅ logged in (qawasa アカウント) |

## 認証方法（正解手順）

**shadow はヘッドレスなので noVNC のターミナルで直接実行するのが最短**:

```bash
# noVNC (http://100.115.94.5:6080/vnc.html) のターミナルで実行
hermes auth add xai-oauth
# → ブラウザが自動起動して accounts.x.ai で認証 → 完了
```

SSHトンネル経由や URL コピペは不要。noVNC ターミナルから直接実行が唯一の正解。

## x_search 動作確認済みコマンド

```bash
# 直接呼び出し（hermes LLM層を省略・高速）
uvx --from hermes-agent python ~/.claude/scripts/run_x_search.py "検索クエリ"

# --full オプションで citations も取得
uvx --from hermes-agent python ~/.claude/scripts/run_x_search.py "検索クエリ" --full
```

## x-learn スキルとの連携

`~/.claude/skills/x-learn/SKILL.md` の方法 B を `run_x_search.py` 直接呼び出しに更新済み（2026-05-25）。

```bash
uvx --from hermes-agent python ~/.claude/scripts/run_x_search.py "{SEARCH_QUERY}" > "${SCRATCHPAD}/x-learn-hermes.txt"
```

## トラブルシューティング

| 症状 | 対処 |
|------|------|
| `logged out` になった | noVNC ターミナルで `hermes auth add xai-oauth` を再実行 |
| `403 bad-credentials` | 同上（トークン失効） |
| SSHトンネルで認証しようとした | やめる。noVNC ターミナルから直接実行が正解 |
| URL コピペ → code を貼り付けようとした | やめる。code は1回限り有効で時間制限あり |

## 注意事項

- `hermes model` で xai-oauth をデフォルト設定しない（API使用なし・x_searchのみ利用）
- x_search は Grok 推論を伴うため 30 秒以上かかることがある（正常）
- `uvx --from hermes-agent` は毎回 hermes パッケージをダウンロードするが、キャッシュされるので2回目以降は高速

## 関連ファイル

- `~/.claude/scripts/run_x_search.py` — x_search 直接呼び出しスクリプト
- `~/.claude/skills/x-learn/SKILL.md` — x-learn スキル（方法 B）
- `~/.hermes/auth.json` — 認証情報保存先
- `~/.claude/rules/grok-hermes-x-search.md` — Grok×Hermes 詳細ガイド