xAI

ผู้ให้บริการค้นหาเว็บ grok แบบ bundled ใช้ XAI_API_KEY ด้วย:

openclaw config set tools.web.search.provider grok

Plugin xai แบบ bundled ลงทะเบียนการสร้างวิดีโอผ่านเครื่องมือร่วม 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 ภาพ

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

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

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

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

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

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

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

Plugin xai แบบ bundled ลงทะเบียนการแปลงข้อความเป็นเสียงผ่านพื้นผิวผู้ให้บริการ tts ร่วม

• เสียง: eve, ara, rex, sal, leo, una
• เสียงเริ่มต้น: eve
• รูปแบบ: mp3, wav, pcm, mulaw, alaw
• ภาษา: รหัส BCP-47 หรือ auto
• ความเร็ว: การแทนที่ความเร็วแบบ native ของผู้ให้บริการ
• ไม่รองรับรูปแบบบันทึกเสียง Opus แบบ native

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

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

Plugin xai แบบ bundled ลงทะเบียนการแปลงเสียงเป็นข้อความแบบแบตช์ผ่านพื้นผิว การถอดเสียงเพื่อทำความเข้าใจสื่อของ OpenClaw

• โมเดลเริ่มต้น: grok-stt
• Endpoint: xAI REST /v1/stt
• เส้นทางอินพุต: การอัปโหลดไฟล์เสียงแบบ multipart
• รองรับโดย OpenClaw ในทุกที่ที่การถอดเสียงขาเข้าใช้ tools.media.audio รวมถึงเซกเมนต์ช่องเสียงของ Discord และ ไฟล์แนบเสียงของช่องทาง

หากต้องการบังคับใช้ xAI สำหรับการถอดเสียงขาเข้า:

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

สามารถระบุภาษาผ่าน config สื่อเสียงร่วม หรือผ่านคำขอถอดเสียง แบบรายครั้งได้ คำใบ้ prompt เป็นที่ยอมรับโดยพื้นผิว OpenClaw ร่วม แต่การผสานรวม REST STT ของ xAI จะส่งต่อเฉพาะไฟล์ โมเดล และ ภาษา เพราะสิ่งเหล่านั้นแมปกับ endpoint สาธารณะปัจจุบันของ xAI ได้ชัดเจน

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

• Endpoint: xAI WebSocket wss://api.x.ai/v1/stt
• การเข้ารหัสเริ่มต้น: mulaw
• sample rate เริ่มต้น: 8000
• endpointing เริ่มต้น: 800ms
• transcript ชั่วคราว: เปิดใช้โดยค่าเริ่มต้น

สตรีมสื่อ 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",
              },
            },
          },
        },
      },
    },
  },
}

การกำหนดค่าที่ Provider เป็นเจ้าของอยู่ใต้ 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 สำหรับ การรันโค้ดระยะไกลในสภาพแวดล้อม sandbox ของ xAI

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

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

• ปัจจุบันการตรวจสอบสิทธิ์ใช้ API key เท่านั้น ยังไม่มีโฟลว์ xAI OAuth หรือ device-code ใน OpenClaw
• grok-4.20-multi-agent-experimental-beta-0304 ไม่รองรับบนเส้นทาง Provider xAI ปกติ เพราะต้องใช้พื้นผิว API ต้นทางที่ต่างจาก transport xAI มาตรฐานของ OpenClaw
• xAI Realtime voice ยังไม่ได้ลงทะเบียนเป็น Provider ของ OpenClaw ต้องใช้ สัญญาเซสชันเสียงสองทิศทางที่ต่างจาก STT แบบแบตช์หรือการถอดเสียงแบบสตรีมมิง
• quality ของภาพ xAI, mask ของภาพ และอัตราส่วนภาพเพิ่มเติมที่มีเฉพาะ native จะไม่ถูกเปิดเผยจนกว่าเครื่องมือ image_generate ที่ใช้ร่วมกันจะมีตัวควบคุม ข้าม Provider ที่สอดคล้องกัน

• OpenClaw ใช้การแก้ไขความเข้ากันได้ของ tool-schema และ tool-call เฉพาะ xAI โดยอัตโนมัติบนเส้นทาง runner ที่ใช้ร่วมกัน
• คำขอ xAI แบบ native ตั้งค่าเริ่มต้นเป็น tool_stream: true ตั้งค่า agents.defaults.models["xai/<model>"].params.tool_stream เป็น false เพื่อ ปิดใช้งาน
• wrapper xAI ที่มาพร้อมกันจะตัดแฟล็ก strict tool-schema และคีย์ reasoning payload ที่ไม่รองรับออกก่อนส่งคำขอ xAI แบบ native
• web_search, x_search, และ code_execution ถูกเปิดเผยเป็นเครื่องมือ OpenClaw OpenClaw จะเปิดใช้งาน built-in ของ xAI ที่ต้องใช้ภายในคำขอเครื่องมือแต่ละรายการ แทนที่จะผูกเครื่องมือ native ทั้งหมดกับทุก chat turn
• Grok web_search อ่าน plugins.entries.xai.config.webSearch.baseUrl x_search อ่าน plugins.entries.xai.config.xSearch.baseUrl จากนั้น fallback ไปยัง URL ฐานของ Grok web-search
• x_search และ code_execution เป็นของ Plugin xAI ที่มาพร้อมกัน แทนที่จะ hardcode ไว้ใน runtime Model หลัก
• code_execution คือการรันใน sandbox xAI ระยะไกล ไม่ใช่ exec ในเครื่อง