xAI

バンドル済みの grok web-search provider は、XAI_API_KEY または plugin の web-search キーを使用できます。

openclaw config set tools.web.search.provider grok

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

• デフォルトの動画モデル: xai/grok-imagine-video
• モード: text-to-video、image-to-video、reference-image 生成、リモート動画編集、リモート動画延長
• アスペクト比: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• 解像度: 480P, 720P
• 長さ: 生成/image-to-video は 1〜15 秒、reference_image ロールの使用時は 1〜10 秒、延長は 2〜10 秒
• Reference-image 生成: すべての提供画像に imageRoles を reference_image として設定します。xAI はそのような画像を最大 7 枚受け付けます

xAI をデフォルトの動画 provider として使用するには:

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

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

• デフォルトの画像モデル: xai/grok-imagine-image
• 追加モデル: xai/grok-imagine-image-pro
• モード: text-to-image と reference-image edit
• 参照入力: 1 つの image、または最大 5 つの images
• アスペクト比: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• 解像度: 1K, 2K
• 件数: 最大 4 画像

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

xAI をデフォルトの画像 provider として使用するには:

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

バンドル済みの xai plugin は、共有 tts provider サーフェスを通じて text-to-speech を登録します。

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

xAI をデフォルトの TTS provider として使用するには:

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

バンドル済みの xai plugin は、OpenClaw のメディア理解文字起こしサーフェスを通じてバッチ speech-to-text を登録します。

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

インバウンド音声文字起こしに xAI を強制するには:

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

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

バンドル済みの xai plugin は、ライブ音声通話音声用のリアルタイム文字起こし provider も登録します。

• エンドポイント: xAI WebSocket wss://api.x.ai/v1/stt
• デフォルトエンコーディング: mulaw
• デフォルトサンプルレート: 8000
• デフォルトエンドポイント判定: 800ms
• 暫定トランスクリプト: デフォルトで有効

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

{  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",          },        },      },    },  },}

• 認証は現在 API キーのみです。API キーは xAI 認証 プロファイル、環境変数、または Plugin 設定に保存できます。OpenClaw にはまだ xAI OAuth や デバイスコードフローはありません。
• grok-4.20-multi-agent-experimental-beta-0304 は、通常の xAI プロバイダーパスでは サポートされていません。標準の OpenClaw xAI トランスポートとは異なる上流 API サーフェスが必要なためです。
• 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 ツールスキーマフラグと reasoning ペイロードキーを取り除きます。
• 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 ではありません。