xAI

隨附的 grok 網頁搜尋提供者可以使用 XAI_API_KEY 或 Plugin 網頁搜尋金鑰：

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
• 模式：文字轉影像與參考影像編輯
• 參考輸入：一個 image 或最多五個 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 音訊檔案上傳
• OpenClaw 中所有使用 tools.media.audio 進行傳入音訊轉錄的地方都支援， 包括 Discord 語音頻道片段與 頻道音訊附件

若要強制 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",              },            },          },        },      },    },  },}

Provider 擁有的設定位於 plugins.entries.voice-call.config.streaming.providers.xai 下。支援的 鍵為 apiKey、baseUrl、sampleRate、encoding（pcm、mulaw 或 alaw）、interimResults、endpointingMs 和 language。

內建的 xAI Plugin 會將 x_search 公開為 OpenClaw 工具，用於透過 Grok 搜尋 X（前 Twitter）內容。

設定路徑：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 會將 code_execution 公開為 OpenClaw 工具，用於在 xAI 的沙盒環境中 遠端執行程式碼。

設定路徑：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 Provider 路徑，因為它需要與標準 OpenClaw xAI 傳輸不同的上游 API 介面。
• xAI Realtime voice 尚未註冊為 OpenClaw Provider。它 需要與批次 STT 或串流轉錄不同的雙向語音工作階段合約。
• xAI 圖片 quality、圖片 mask，以及額外僅限原生的長寬比， 要等到共用的 image_generate 工具具備對應的跨 Provider 控制後才會公開。

• OpenClaw 會在共用 runner 路徑上自動套用 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 網頁搜尋基底 URL。
• x_search 和 code_execution 由內建的 xAI Plugin 擁有， 而不是硬編碼到核心模型執行階段。
• code_execution 是遠端 xAI 沙盒執行，不是本機 exec。