メインコンテンツへスキップ

​
xAI

OpenClawには、Grokモデル用のバンドルされたxaiプロバイダープラグインが含まれています。

​
セットアップ

  1. xAIコンソールでAPIキーを作成します。
  2. XAI_API_KEYを設定するか、次を実行します:
openclaw onboard --auth-choice xai-api-key
  1. 次のようなモデルを選択します:
{
  agents: { defaults: { model: { primary: "xai/grok-4" } } },
}
OpenClawは現在、バンドルされたxAIトランスポートとしてxAI Responses APIを使用します。同じ XAI_API_KEYは、Grokベースのweb_search、ファーストクラスのx_search、およびリモートのcode_executionにも使用できます。 plugins.entries.xai.config.webSearch.apiKey配下にxAIキーを保存した場合、バンドルされたxAIモデルプロバイダーはそのキーもフォールバックとして再利用します。 code_executionの調整項目はplugins.entries.xai.config.codeExecution配下にあります。

​
現在のバンドルモデルカタログ

OpenClawには現在、これらのxAIモデルファミリーが標準で含まれています。
  • grok-3, grok-3-fast, grok-3-mini, grok-3-mini-fast
  • grok-4, grok-4-0709
  • grok-4-fast, grok-4-fast-non-reasoning
  • grok-4-1-fast, grok-4-1-fast-non-reasoning
  • grok-4.20-beta-latest-reasoning, grok-4.20-beta-latest-non-reasoning
  • grok-code-fast-1
このプラグインは、同じAPI形状に従う新しいgrok-4*およびgrok-code-fast* idも前方解決します。 高速モデルに関するメモ:
  • grok-4-fast、grok-4-1-fast、およびgrok-4.20-beta-*バリアントは、現在バンドルカタログ内で画像対応のGrok参照です。
  • /fast onまたはagents.defaults.models["xai/<model>"].params.fastMode: true は、ネイティブxAIリクエストを次のように書き換えます:
    • grok-3 -> grok-3-fast
    • grok-3-mini -> grok-3-mini-fast
    • grok-4 -> grok-4-fast
    • grok-4-0709 -> grok-4-fast
レガシー互換エイリアスは引き続き正式なバンドルidへ正規化されます。たとえば:
  • grok-4-fast-reasoning -> grok-4-fast
  • grok-4-1-fast-reasoning -> grok-4-1-fast
  • grok-4.20-reasoning -> grok-4.20-beta-latest-reasoning
  • grok-4.20-non-reasoning -> grok-4.20-beta-latest-non-reasoning

​
Web検索

バンドルされたgrok Web検索プロバイダーもXAI_API_KEYを使います: 
openclaw config set tools.web.search.provider grok

​
動画生成

バンドルされたxaiプラグインは、共有のvideo_generateツールを通じた動画生成も登録します。
  • デフォルト動画モデル: xai/grok-imagine-video
  • モード: テキストから動画、画像から動画、およびリモート動画の編集/延長フロー
  • aspectRatioとresolutionをサポート
  • 現在の制限: ローカル動画バッファーは受け付けられません。動画参照/編集入力にはリモートのhttp(s) URLを使用してください
xAIをデフォルトの動画プロバイダーとして使うには: 
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "xai/grok-imagine-video",
      },
    },
  },
}
共有ツールのパラメーター、プロバイダー選択、およびフェイルオーバー動作については、Video Generationを参照してください。

​
既知の制限

  • 認証は現在APIキーのみです。OpenClawにはまだxAIのOAuth/device-codeフローはありません。
  • grok-4.20-multi-agent-experimental-beta-0304は、標準のOpenClaw xAIトランスポートとは異なる上流APIサーフェスを必要とするため、通常のxAIプロバイダー経路ではサポートされていません。

​
メモ

  • OpenClawは、共有ランナー経路上でxAI固有のツールスキーマおよびツール呼び出し互換修正を自動的に適用します。
  • ネイティブxAIリクエストでは、デフォルトでtool_stream: trueになります。無効にするには、 agents.defaults.models["xai/<model>"].params.tool_streamをfalseに設定してください。
  • バンドルされたxAIラッパーは、ネイティブxAIリクエスト送信前に、未対応の厳格なツールスキーマフラグとreasoningペイロードキーを削除します。
  • web_search、x_search、およびcode_executionはOpenClawツールとして公開されています。OpenClawは、各ツールリクエスト内で必要な特定のxAI組み込み機能だけを有効化し、すべてのネイティブツールをすべてのチャットターンに付与することはありません。
  • x_searchとcode_executionは、コアモデルランタイムにハードコードされているのではなく、バンドルされたxAIプラグインが所有しています。
  • code_executionはリモートのxAIサンドボックス実行であり、ローカルのexecではありません。
  • より広いプロバイダー概要については、Model providersを参照してください。