openclaw onboard は既定で 127.0.0.1:56121 のブラウザコールバックを開こうとし、GUI のないリモート Mac では認可が完了せず、ログは「OAuth コールバック待ち」のままです。OpenClaw v2026.5.20（2026-05-21）で xAI Device-Code OAuth が正式に入り、純ターミナルで Grok ログインが可能になりました。本文は 2026 年に実行できる経路を示します。三方式の認証決定表、openclaw update アップグレード Runbook、Device-Code 六ステップ骨格、アップグレード後の Node 22.19 と Gateway ヘルスチェック一覧です。
ヘッドレスクラウド Mac で Grok 認証に多い五つの誤読パターン
OpenClaw の 2026 年 xAI Provider は API Key、ブラウザ Loopback OAuth、Device-Code OAuth の三経路をサポートします。クラウド Mac 運用が「SSH で入れる＝Grok 認可もできる」と見做すと、初時間に Gateway を何度も入れ直し、真因は認証方式の選択ミスかNode 22.19 未満のまま残ります。v2026.5.20 は openclaw update が複数 Node 環境で Gateway のバイナリを黙って切り替える問題も直しています。アップグレード後に doctor を飛ばすと、チャネルは「接続済み」でもモデル呼び出しが 401 になることがあります。変更票では先に署名番号を付け、Device-Code へ切り替えるか、Node パスを固定するか、Gateway をより高いスペックのクラウド Mac へ移すかを決めてください。
GUI のないクラウド Mac でブラウザ OAuth を選ぶ：Loopback コールバックは本機ブラウザが 127.0.0.1:56121 を開く前提です。SSH のみでは完遂できないため、--device-code か xai-device-code onboard オプションに切り替えてください。
Device-Code の短コードを API Key として config に書く：Device-Code は一度きりの認可フローで、完了後 Token は auth profile に保存されます。検証コード文字列を openclaw.json に直書きしてはいけません。
v2026.5.20 へ上げたあと Node 一致を確認しない：この版は Gateway と CLI が別 Node バイナリを使う問題を修正しました。アップグレード後は必ず openclaw doctor を実行し、managed service の Node パスを照合してください。
OAuth 成功後もデフォルトモデルが OpenAI のまま：Device-Code 完了後は openclaw models set xai/grok-4.3（または対象 Grok 型番）が必要です。さもないと Agent は旧 Provider にルーティングされます。
16GB クラウド Mac で Grok クラウド推論とローカル Ollama 大モデルを同時実行：Gateway 自体は軽量ですが、ブラウザ自動化と並列ツール呼び出しでメモリを使い切ります。仕様の分水嶺表を参照し 24GB か分離を選んでください。
これらの署名はサイト内のヘッドレス SSH 初時間チェックリストとOllama ハイブリッド Provider ガイドと補完関係にあります。初時間で Node と Gateway 基線を固め、本文は v2026.5.20 の Grok OAuth 新機能とアップグレード受け入れに焦点を当てます。
xAI API Key、ブラウザ OAuth、Device-Code OAuth はどう選びますか。
xAI 公式ドキュメントでは、Grok OAuth は SuperGrok または X Premium 契約資格のあるアカウント向けで、別途 API Key を購入する必要はありません。OpenClaw は local-first Gateway として、認証 Token をクラウド Mac の状態ディレクトリに保存し、モデル要求は xAI API へ出站します。三方式の差は認可の対話形態とヘッドレス環境への適合度にあり、Grok モデル能力そのものではありません。
| 観点 | API Key | ブラウザ Loopback OAuth | Device-Code OAuth（v2026.5.20+） |
|---|---|---|---|
| 向く場面 | xAI 開発者 Key あり、一括自動化 | macOS/Windows 本機に GUI、ブラウザ起動可 | SSH クラウド Mac、Docker、GUI なし VPS |
| 対話方式 | 環境変数または config に Key 記載 | 127.0.0.1:56121 コールバックを自動起動 | 端末に URL + 短コード、任意端末のブラウザで認可 |
| ヘッドレスクラウド Mac | 可能だが有料 Key が必要 | SSH ポート転送または VNC が必要 | 推奨デフォルト経路 |
| Token 保存 | 静的 Key | xai/oauth auth profile | 同左、ポーリング完了後に自動永続化 |
| クラウド Mac Gateway | 本番向きだが呼び出し量に比例してコスト増 | 初回セットアップは楽、純 SSH 運用には不向き | MESHLAUNCH 六リージョン裸金属 7×24 Gateway と最も整合 |
裸金属クラウド Mac で 7×24 本番 Gateway を回すなら、Device-Code OAuth は VNC なしで Grok サブスクリプション認証を完遂できる唯一の公式経路です。
チームが Ollama でローカルフォールバックを使っているなら、Grok をクラウド主モデルにできます。ルーティング方針はハイブリッド Provider 記事を参照し、本文ではモデル切替全文は繰り返しません。OAuth 完了後は openclaw models list で xai/grok-4.3 が利用可能かつデフォルトかを確認してください。
OpenClaw v2026.5.20 アップグレードと Device-Code コマンド骨格
v2026.5.20 は 2026-05-21 にリリースされ、主な変更は xAI Device-Code OAuth（PR #84005）、CLI/update が複数 Node 環境でも managed Gateway に同一 Node バイナリを使わせる修正、Windows install.ps1 ウィザード描画の修正です。2026.5.19 から Node.js 最低版は 22.19 に引き上げられ、それ未満では doctor が通ってもプラグイン読み込みが不安定になることがあります。アップグレード前は openclaw update --dry-run で変更をプレビューし、変更窓内で Gateway 再起動と channels probe を完了してください。
node -v openclaw update --dry-run openclaw update openclaw gateway restart openclaw onboard --install-daemon --auth-choice xai-device-code openclaw models auth login --provider xai --device-code openclaw models set xai/grok-4.3 openclaw doctor openclaw channels probe
ヒント：Gateway が既に入っており Grok 認証だけ足すなら、フル onboard を飛ばし models auth login --provider xai --device-code だけで構いません。Device-Code フローは xAI 検証 URL と短コードを表示するので、任意のローカルブラウザで認可し、SSH 端末は Token 交換成功までポーリングを維持してください。
Device-Code と Loopback OAuth の consent ページに Grok Build と表示されることがあります。これは xAI 共有 OAuth クライアントの正常な挙動で、OpenClaw ドキュメントは Grok Build アプリのインストールを要求しません。認可成功後、状態ディレクトリに xai/oauth auth profile ができ、openclaw models auth list で確認できます。版を戻す必要がある場合は、サイト内のupdate 配信チャネルとロールバック Runbookで dist-tag を固定してから doctor を実行してください。
六ステップ Runbook：アップグレードから Grok 利用可能 + Gateway 受け入れまで
Node 22.19 基線受け入れ：node -v で ≥ 22.19 を確認します。複数 Node 環境では which node と LaunchAgent plist 内の Node パスを照合し、v2026.5.20 修正前のバイナリ漂流を再発させないでください。
ドライランアップグレード：openclaw update --dry-run で目標版とプラグイン変更を記録します。本番 Gateway は低トラフィック窓を選び、先に openclaw backup create --verify（または状態ディレクトリの tar）を取ってください。
アップグレード実行と Gateway 再起動：openclaw update → openclaw gateway restart → openclaw gateway status で active を確認。openclaw --version が 2026.5.20 であることも照合します。
Device-Code Grok 認可：新規は onboard --install-daemon --auth-choice xai-device-code。既存 Gateway は models auth login --provider xai --device-code。端末に表示された URL をローカルブラウザで開き短コードを入力します。
デフォルトモデルとプローブ：openclaw models set xai/grok-4.3。openclaw infer model run --local --model xai/grok-4.3 --prompt 'ping' で推論経路を検証し、openclaw doctor --fix で config 漂流を処理します。
チャネルと 7×24 受け入れ：openclaw channels probe を全緑にします。SSH を切って 10 分待って再度 probe し、LaunchAgent 常駐が効いていることを確認。版、Node パス、auth profile のスナップショットを Runbook に記録してください。
三本の当番閾値と六リージョンクラウド Mac Gateway 仕様対照
Node 版の赤線：公式 2026.5.19+ は Node 22.19 を下限とします。クラウド Mac 初回で install.sh が古い Node を取る場合、OpenClaw を上げる前に nvm install 22 かシステム級アップグレードを行い、doctor とプラグイン registry の挙動差を避けてください。
Device-Code タイムアウト閾値：ポーリング窓は通常数分です。SSH セッションが idle で切れて認可失敗する場合は tmux か mosh で端末を維持し、ローカルブラウザで検証完了後に端末出力を確認してください。
メモリの分水嶺：Gateway + Grok クラウド推論自体は modest ですが、OpenClaw ブラウザ自動化と並列 tool call は 16GB クラウド Mac で Swap を招きやすいです。重タスク Gateway は 24GB か M4 Pro クラスを推奨し、軽量チャネル Bot は 16GB 日次レンタルで試走できます。
注意：閾値は当番連絡用の目安であり、ベンダ SLA ではありません。xAI OAuth 資格は xAI アカウントポリシー次第で、OpenClaw が迂回することはできません。
Grok Gateway をローカルノートに縛ると、スリープ、ローミング回線、OAuth コールバック未到達が戻ります。安価な Linux VPS だけでは Node は動きますが、macOS ブラウザ自動化ツールチェーンから離れます。裸金属クラウド Mac を 7×24 Gateway に置き、SSH で Device-Code 認可を完遂する構成は、Apple エコシステムの近接性、loopback セキュリティ規律、予測可能な換え窓のバランスが取れます。Grok サブスクリプション駆動 Agent を求めつつ消費者ハードの常時オンラインに賭けたくないチームには、MESHLAUNCH の Mac Mini クラウドレンタルが現実的です。目標リージョンで日次レンタルから六ステップと Gateway 再起動を一度通し、状態が固まってから月次にロックする順序をおすすめします。容量と申込は レンタル料金 と ヘルプセンター をご覧ください。
GUI がない場合はDevice-Code を推奨します。VNC を開いている、または 127.0.0.1:56121 のポート転送をしているならブラウザ OAuth も使えます。ヘッドレス初時間チェックリストを参照し、申込は 料金ページです。
先に openclaw doctor と which node を実行し、managed service の Node と CLI が一致するか確認します。続けて gateway status と channels probe を取ります。ロールバックは update ロールバック Runbookを参照してください。