xAI

內建的 grok 網頁搜尋供應商會優先使用 xAI OAuth，接著才備援至 XAI_API_KEY 或外掛的網頁搜尋金鑰：

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

內建的 xai 外掛會透過共用的 video_generate 工具註冊影片生成功能。

• 預設模型：xai/grok-imagine-video
• 其他模型：xai/grok-imagine-video-1.5
• 經典模式：文字轉影片、圖片轉影片、參考圖片生成、遠端影片編輯，以及遠端影片延伸
• Video 1.5 模式：僅限圖片轉影片，而且必須恰好提供一張首幀圖片
• 長寬比：1:1、16:9、9:16、4:3、3:4、3:2、2:3；若省略，經典模式與 Video 1.5 的圖片轉影片會沿用來源圖片的比例
• 解析度：經典模式支援 480P／720P；Video 1.5 也支援 1080P；所有生成模式預設為 480P
• 時長：生成／圖片轉影片為 1 至 15 秒；使用經典模式的 reference_image 角色時為 1 至 10 秒；經典延伸模式為 2 至 10 秒
• 參考圖片生成：將每張提供的圖片之 imageRoles 設為 reference_image；xAI 最多接受 7 張此類圖片
• 影片編輯／延伸會沿用輸入影片的長寬比與解析度；這些操作不接受幾何參數覆寫
• 預設操作逾時：600 秒，除非已設定 video_generate.timeoutMs 或 agents.defaults.videoGenerationModel.timeoutMs

Video 1.5 也能識別 xAI 的 grok-imagine-video-1.5-preview 與 grok-imagine-video-1.5-2026-05-30 識別碼。OpenClaw 會原樣轉送所選識別碼，但套用相同的僅限圖片驗證。

若要將 xAI 設為預設影片供應商：

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

內建的 xai 外掛會透過共用的 image_generate 工具註冊圖片生成功能。

• 預設圖片模型：xai/grok-imagine-image
• 其他模型：xai/grok-imagine-image-quality
• 模式：文字轉圖片與參考圖片編輯
• 參考輸入：一個 image 或最多三個 images
• 長寬比：1:1、16:9、9:16、4:3、3:4、3:2、2:3、2:1、 1:2、19.5:9、9:19.5、20:9、9:20
• 解析度：1K、2K
• 數量：最多 4 張圖片
• 預設操作逾時：600 秒，除非已設定 image_generate.timeoutMs 或 agents.defaults.imageGenerationModel.timeoutMs

OpenClaw 會要求 xAI 傳回 b64_json 圖片回應，以便透過一般頻道附件路徑 儲存及傳送產生的媒體。本機參考圖片會轉換為資料 URL；遠端 http(s) 參考則會原樣傳遞。

若要使用 xAI 作為預設圖片供應商：

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

隨附的 xai 外掛會透過共用的 tts 供應商介面註冊文字轉語音功能。

• 語音：來自 xAI、需驗證的即時目錄；可使用 openclaw infer tts voices --provider xai 列出
• 離線備援語音：ara、eve、leo、rex、sal
• 預設語音：eve
• 即使帳戶的自訂語音 ID 未出現在內建目錄回應中，仍會予以轉送
• 格式：mp3、wav、pcm、mulaw、alaw
• 語言：BCP-47 代碼或 auto
• 速度：供應商原生速度覆寫
• 不支援原生 Opus 語音留言格式

若要使用 xAI 作為預設 TTS 供應商：

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

隨附的 xai 外掛會透過 OpenClaw 的媒體理解轉錄介面， 註冊批次語音轉文字功能。

• 端點：xAI REST /v1/stt
• 輸入路徑：多部分音訊檔案上傳
• 模型選擇：xAI 會在內部選擇轉錄模型；該端點沒有模型選擇器
• 適用於所有讀取 tools.media.audio 的傳入音訊轉錄，包括 Discord 語音頻道片段與頻道音訊附件

若要強制使用 xAI 進行傳入音訊轉錄：

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",          },        ],      },    },  },}

可透過共用音訊媒體設定或每次呼叫的轉錄請求提供語言。 共用 OpenClaw 介面接受提示內容，但 xAI REST STT 整合只會轉送檔案與語言， 因為只有這些欄位能對應至目前公開的 xAI 端點。

隨附的 xai 外掛也會為即時語音通話音訊註冊即時轉錄供應商。

• 端點：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 外掛會將 x_search 公開為 OpenClaw 工具， 以透過 Grok 搜尋 X（前身為 Twitter）的內容。

設定路徑：plugins.entries.xai.config.xSearch

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

隨附的 xAI 外掛會將 code_execution 公開為 OpenClaw 工具， 以便在 xAI 的沙箱環境中遠端執行程式碼。

設定路徑：plugins.entries.xai.config.codeExecution

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4.3",          },        },      },    },  },}

• xAI 驗證可使用 API 金鑰、環境變數、外掛設定備援，或透過符合資格的 xAI 帳戶使用 OAuth。OAuth 使用裝置代碼驗證，不需要 localhost 回呼。xAI 會決定哪些帳戶可以取得 OAuth API 權杖，而且即使 OpenClaw 不需要 Grok Build 應用程式，同意頁面仍可能顯示 Grok Build。
• OpenClaw 目前不會公開 xAI 多代理模型系列。xAI 透過 Responses API 提供這些模型，但它們不接受 OpenClaw 共用代理迴圈所使用的 用戶端工具或自訂工具。請參閱 xAI 多代理限制。
• xAI Realtime 語音尚未註冊為 OpenClaw 供應商。它需要與批次 STT 或串流轉錄不同的雙向語音工作階段合約。
• 在共用 image_generate 工具提供對應的跨供應商控制項之前， xAI 圖片的 quality、圖片 mask 與原生 auto 長寬比不會公開。

• OpenClaw 會在共用執行器路徑上，自動套用 xAI 專用的工具結構描述與工具呼叫相容性修正。
• 原生 xAI 請求預設使用 tool_stream: true。將 agents.defaults.models["xai/<model>"].params.tool_stream 設為 false 即可停用。
• 隨附的 xAI 包裝器會在傳送原生 xAI 請求前，移除不受支援的包含項目數量結構描述界限， 以及不受支援的推理 強度 承載資料鍵。Grok 4.5 支援低、中與 高強度（預設為高）。Grok 4.3 支援無、低、中與高 強度（預設為低）。其他具備推理能力的 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 網頁搜尋基底 URL。
• x_search 與 code_execution 由隨附的 xAI 外掛擁有， 而非硬編碼至核心模型執行階段。
• code_execution 是遠端 xAI 沙箱執行，而非本機的 exec。