xAI

ผู้ให้บริการ web-search grok แบบบันเดิลจะเลือกใช้ xAI OAuth ก่อน แล้วจึงถอยกลับ ไปใช้ XAI_API_KEY หรือคีย์ web-search ของ Plugin:

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

Plugin xai แบบบันเดิลลงทะเบียนการสร้างวิดีโอผ่านเครื่องมือแบบใช้ร่วมกัน 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
• ระยะเวลา: 1-15 วินาทีสำหรับการสร้าง/image-to-video, 1-10 วินาทีเมื่อ ใช้บทบาท reference_image, 2-10 วินาทีสำหรับการต่อขยาย
• การสร้าง reference-image: ตั้งค่า imageRoles เป็น reference_image สำหรับ รูปภาพที่ให้มาทุกภาพ; xAI รับรูปภาพดังกล่าวได้สูงสุด 7 ภาพ
• timeout การดำเนินการเริ่มต้น: 600 วินาที เว้นแต่จะตั้งค่า video_generate.timeoutMs หรือ agents.defaults.videoGenerationModel.timeoutMs

หากต้องการใช้ xAI เป็นผู้ให้บริการวิดีโอเริ่มต้น:

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

Plugin xai แบบบันเดิลลงทะเบียนการสร้างรูปภาพผ่านเครื่องมือแบบใช้ร่วมกัน image_generate

• โมเดลรูปภาพเริ่มต้น: xai/grok-imagine-image
• โมเดลเพิ่มเติม: xai/grok-imagine-image-quality
• โหมด: text-to-image และการแก้ไข reference-image
• อินพุตอ้างอิง: image หนึ่งรายการ หรือ images สูงสุดห้ารายการ
• อัตราส่วนภาพ: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• ความละเอียด: 1K, 2K
• จำนวน: สูงสุด 4 รูปภาพ
• timeout การดำเนินการเริ่มต้น: 600 วินาที เว้นแต่จะตั้งค่า image_generate.timeoutMs หรือ agents.defaults.imageGenerationModel.timeoutMs

OpenClaw ขอการตอบกลับรูปภาพแบบ b64_json จาก xAI เพื่อให้สื่อที่สร้างขึ้นสามารถ จัดเก็บและส่งผ่านเส้นทางไฟล์แนบของช่องทางปกติได้ รูปภาพอ้างอิงภายในเครื่อง จะถูกแปลงเป็น data URL; การอ้างอิง http(s) ระยะไกลจะถูกส่งผ่านตามเดิม

หากต้องการใช้ xAI เป็นผู้ให้บริการรูปภาพเริ่มต้น:

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

Plugin xai ที่รวมมาให้ลงทะเบียนข้อความเป็นเสียงพูดผ่านพื้นผิวผู้ให้บริการ 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: {          speakerVoiceId: "eve",        },      },    },  },}

Plugin xai ที่รวมมาให้ลงทะเบียนเสียงพูดเป็นข้อความแบบแบตช์ผ่านพื้นผิวการถอดเสียง เพื่อทำความเข้าใจสื่อของ 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 สาธารณะ ในปัจจุบันได้อย่างชัดเจน

Plugin xai ที่รวมมาให้ยังลงทะเบียนผู้ให้บริการถอดเสียงแบบเรียลไทม์ สำหรับเสียงการโทรสด

• ปลายทาง: xAI WebSocket wss://api.x.ai/v1/stt
• การเข้ารหัสเริ่มต้น: mulaw
• อัตราสุ่มตัวอย่างเริ่มต้น: 8000
• การกำหนดจุดสิ้นสุดเริ่มต้น: 800ms
• ข้อความถอดเสียงระหว่างทาง: เปิดใช้เป็นค่าเริ่มต้น

สตรีมสื่อ Twilio ของ Voice Call ส่งเฟรมเสียง 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

Plugin xAI ที่รวมมาให้เปิดเผย x_search เป็นเครื่องมือของ OpenClaw สำหรับค้นหา เนื้อหา X (เดิมคือ Twitter) ผ่าน Grok

เส้นทางการกำหนดค่า: 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,          },        },      },    },  },}

Plugin xAI ที่รวมมาให้เปิดเผย code_execution เป็นเครื่องมือของ OpenClaw สำหรับ การเรียกใช้โค้ดระยะไกลในสภาพแวดล้อมแซนด์บ็อกซ์ของ xAI

เส้นทางการกำหนดค่า: plugins.entries.xai.config.codeExecution

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4-1-fast",          },        },      },    },  },}

• การยืนยันตัวตน xAI สามารถใช้คีย์ API, ตัวแปรสภาพแวดล้อม, ค่าถอยกลับจากการกำหนดค่า Plugin หรือ OAuth กับบัญชี xAI ที่เข้าเกณฑ์ OAuth ใช้การยืนยันด้วยรหัสอุปกรณ์ โดยไม่มี callback localhost xAI เป็นผู้ตัดสินว่าบัญชีใดรับโทเค็น API ผ่าน OAuth ได้ และหน้าความยินยอมอาจแสดง Grok Build แม้ว่า OpenClaw จะไม่ต้องใช้แอป Grok Build
• ปัจจุบัน OpenClaw ยังไม่เปิดเผยตระกูลโมเดลหลายเอเจนต์ของ xAI xAI ให้บริการโมเดลเหล่านี้ผ่าน Responses API แต่โมเดลเหล่านี้ไม่รับ เครื่องมือฝั่งไคลเอนต์หรือเครื่องมือกำหนดเองที่ลูปเอเจนต์ร่วมของ OpenClaw ใช้ ดู ข้อจำกัดหลายเอเจนต์ของ xAI
• เสียง 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 ที่รวมมาให้จะตัดแฟล็กสคีมาเครื่องมือแบบเข้มงวดที่ไม่รองรับ และ คีย์เพย์โหลด effort สำหรับการให้เหตุผลออกก่อนส่งคำขอ xAI แบบเนทีฟ มีเพียง grok-4.3 / grok-4.3-* เท่านั้นที่ประกาศว่าสามารถกำหนด effort สำหรับการให้เหตุผลได้; โมเดล xAI อื่นทั้งหมดที่มีความสามารถในการให้เหตุผลยังคงขอ include: ["reasoning.encrypted_content"] เพื่อให้สามารถเล่นซ้ำการให้เหตุผลที่เข้ารหัสก่อนหน้า ในรอบติดตามผลได้
• web_search, x_search และ code_execution ถูกเปิดเผยเป็นเครื่องมือของ OpenClaw OpenClaw เปิดใช้ built-in เฉพาะของ xAI ที่ต้องการภายในคำขอเครื่องมือแต่ละรายการ แทนที่จะผูกเครื่องมือเนทีฟทั้งหมดเข้ากับทุกๆ รอบแชต
• Grok web_search อ่าน plugins.entries.xai.config.webSearch.baseUrl x_search อ่าน plugins.entries.xai.config.xSearch.baseUrl แล้ว ถอยกลับไปใช้ URL ฐานของ Grok web-search
• x_search และ code_execution เป็นของ Plugin xAI ที่รวมมาให้ แทนที่จะ hardcode ลงในรันไทม์โมเดลหลัก
• code_execution คือการเรียกใช้แซนด์บ็อกซ์ xAI ระยะไกล ไม่ใช่ exec ภายในเครื่อง