xAI

バンドル済みの grok Web 検索プロバイダーは xAI OAuth を優先し、その後 XAI_API_KEY または Plugin の Web 検索キーにフォールバックします。

openclaw models auth login --provider xai --method oauthopenclaw config set tools.web.search.provider grok

バンドル済み xai Plugin は、共有 video_generate ツールを通じて動画生成を登録します。

• デフォルト動画モデル: xai/grok-imagine-video
• モード: テキストから動画、画像から動画、参照画像生成、リモート 動画編集、リモート動画延長
• アスペクト比: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• 解像度: 480P, 720P
• 長さ: 生成/画像から動画では 1〜15 秒、 reference_image ロールを使用する場合は 1〜10 秒、延長では 2〜10 秒
• 参照画像生成: 提供するすべての画像で imageRoles を reference_image に設定します。xAI はそのような画像を最大 7 枚まで受け付けます
• デフォルト操作タイムアウト: video_generate.timeoutMs または agents.defaults.videoGenerationModel.timeoutMs が設定されていない限り 600 秒

xAI をデフォルト動画プロバイダーとして使用するには、次のようにします。

{  agents: {    defaults: {      videoGenerationModel: {        primary: "xai/grok-imagine-video",      },    },  },}

バンドル済み xai Plugin は、共有 image_generate ツールを通じて画像生成を登録します。

• デフォルト画像モデル: xai/grok-imagine-image
• 追加モデル: xai/grok-imagine-image-quality
• モード: テキストから画像、参照画像編集
• 参照入力: 1 つの image または最大 5 つの images
• アスペクト比: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• 解像度: 1K, 2K
• 枚数: 最大 4 枚
• デフォルト操作タイムアウト: image_generate.timeoutMs または agents.defaults.imageGenerationModel.timeoutMs が設定されていない限り 600 秒

OpenClaw は xAI に b64_json 画像レスポンスを要求するため、生成されたメディアを 通常のチャンネル添付パスを通じて保存および配信できます。ローカル 参照画像はデータ URL に変換され、リモート http(s) 参照はそのまま渡されます。

xAI をデフォルト画像プロバイダーとして使用するには、次のようにします。

{  agents: {    defaults: {      imageGenerationModel: {        primary: "xai/grok-imagine-image",      },    },  },}

バンドルされた xai Plugin は、共有 tts プロバイダーサーフェスを通じて テキスト読み上げを登録します。

• 音声: eve、ara、rex、sal、leo、una
• デフォルト音声: eve
• 形式: mp3、wav、pcm、mulaw、alaw
• 言語: BCP-47 コードまたは auto
• 速度: プロバイダーネイティブの速度上書き
• ネイティブ Opus ボイスメモ形式はサポートされていません

xAI をデフォルトの TTS プロバイダーとして使用するには:

{  messages: {    tts: {      provider: "xai",      providers: {        xai: {          speakerVoiceId: "eve",        },      },    },  },}

バンドルされた xai Plugin は、OpenClaw のメディア理解文字起こし サーフェスを通じてバッチ音声テキスト変換を登録します。

• デフォルトモデル: grok-stt
• エンドポイント: xAI REST /v1/stt
• 入力パス: multipart 音声ファイルアップロード
• Discord 音声チャンネルセグメントやチャンネル音声添付を含め、 受信音声文字起こしが tools.media.audio を使用する場所では OpenClaw によってサポートされます

受信音声文字起こしに xAI を強制するには:

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",            model: "grok-stt",          },        ],      },    },  },}

言語は、共有音声メディア設定または呼び出しごとの文字起こしリクエストで 指定できます。プロンプトヒントは共有 OpenClaw サーフェスで受け付けられますが、 xAI REST STT 統合は、現在の公開 xAI エンドポイントにきれいに対応する ファイル、モデル、言語のみを転送します。

バンドルされた xai Plugin は、ライブ音声通話音声用のリアルタイム 文字起こしプロバイダーも登録します。

• エンドポイント: xAI WebSocket wss://api.x.ai/v1/stt
• デフォルトエンコーディング: mulaw
• デフォルトサンプルレート: 8000
• デフォルトエンドポインティング: 800ms
• 暫定文字起こし: デフォルトで有効

Voice Call の Twilio メディアストリームは G.711 µ-law 音声フレームを送信するため、 xAI プロバイダーはトランスコードせずにそれらのフレームを直接転送できます。

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "xai",            providers: {              xai: {                apiKey: "${XAI_API_KEY}",                endpointingMs: 800,                language: "en",              },            },          },        },      },    },  },}

プロバイダー所有の設定は plugins.entries.voice-call.config.streaming.providers.xai の下にあります。 サポートされるキーは apiKey、baseUrl、sampleRate、encoding（pcm、 mulaw、または alaw）、interimResults、endpointingMs、language です。

バンドルされた xAI Plugin は、Grok 経由で X（旧 Twitter）コンテンツを検索する OpenClaw ツールとして x_search を公開します。

設定パス: plugins.entries.xai.config.xSearch

{  plugins: {    entries: {      xai: {        config: {          xSearch: {            enabled: true,            model: "grok-4-1-fast",            baseUrl: "https://api.x.ai/v1",            inlineCitations: true,          },        },      },    },  },}

バンドルされた xAI Plugin は、xAI のサンドボックス環境でリモートコード実行を行う OpenClaw ツールとして code_execution を公開します。

設定パス: plugins.entries.xai.config.codeExecution

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4-1-fast",          },        },      },    },  },}

• xAI 認証では、API キー、環境変数、Plugin 設定フォールバック、または対象となる xAI アカウントでの OAuth を使用できます。OAuth は localhost コールバックなしの デバイスコード検証を使用します。どのアカウントが OAuth API トークンを受け取れるかは xAI が決定し、同意ページには OpenClaw が Grok Build アプリを必要としない場合でも Grok Build が表示されることがあります。
• OpenClaw は現在、xAI マルチエージェントモデルファミリーを公開していません。xAI は Responses API を通じてこれらのモデルを提供しますが、OpenClaw の共有エージェントループで 使用されるクライアント側ツールやカスタムツールを受け付けません。 xAI マルチエージェントの制限を参照してください。
• xAI Realtime 音声は、まだ OpenClaw プロバイダーとして登録されていません。バッチ STT や ストリーミング文字起こしとは異なる双方向音声セッション契約が必要です。
• xAI 画像 quality、画像 mask、追加のネイティブ専用アスペクト比は、共有 image_generate ツールに対応するクロスプロバイダー制御が追加されるまで公開されません。

• OpenClaw は、共有ランナーパスで xAI 固有のツールスキーマおよびツール呼び出し互換性修正を 自動的に適用します。
• ネイティブ xAI リクエストのデフォルトは tool_stream: true です。無効にするには agents.defaults.models["xai/<model>"].params.tool_stream を false に設定します。
• バンドルされた xAI ラッパーは、ネイティブ xAI リクエストを送信する前に、サポートされない strict ツールスキーマフラグと推論 effort ペイロードキーを取り除きます。 grok-4.3 / grok-4.3-* のみが設定可能な推論 effort を広告します。他のすべての 推論対応 xAI モデルは、後続ターンで以前の暗号化済み推論を再生できるように、 引き続き include: ["reasoning.encrypted_content"] をリクエストします。
• web_search、x_search、code_execution は OpenClaw ツールとして公開されます。 OpenClaw はすべてのネイティブツールをすべてのチャットターンに添付するのではなく、 各ツールリクエスト内で必要な特定の xAI 組み込み機能を有効にします。
• Grok web_search は plugins.entries.xai.config.webSearch.baseUrl を読み取ります。 x_search は plugins.entries.xai.config.xSearch.baseUrl を読み取り、その後 Grok web-search ベース URL にフォールバックします。
• x_search と code_execution は、コアモデルランタイムにハードコードされるのではなく、 バンドルされた xAI Plugin が所有します。
• code_execution はリモート xAI サンドボックス実行であり、ローカルの exec ではありません。