xAI

バンドル済みの grok Web 検索プロバイダーも XAI_API_KEY を使用します。

openclaw 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 枚受け付けます

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

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

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

• デフォルトの画像モデル: xai/grok-imagine-image
• 追加モデル: xai/grok-imagine-image-pro
• モード: テキストから画像、参照画像編集
• 参照入力: 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 をデフォルトの画像プロバイダーとして使用するには:

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

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

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

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

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

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

バンドル済みの 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",
              },
            },
          },
        },
      },
    },
  },
}

Provider 所有の設定は 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 キーのみです。OpenClaw にはまだ xAI OAuth やデバイスコードフローはありません。
• grok-4.20-multi-agent-experimental-beta-0304 は、標準の OpenClaw xAI トランスポートとは異なるアップストリーム API サーフェスを必要とするため、通常の xAI provider パスではサポートされていません。
• xAI Realtime 音声は、まだ OpenClaw provider として登録されていません。バッチ 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 ではありません。