xAI

Nhà cung cấp tìm kiếm web grok được cung cấp sẵn ưu tiên xAI OAuth, rồi dự phòng về XAI_API_KEY hoặc khóa tìm kiếm web của plugin:

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

Plugin xai được cung cấp sẵn đăng ký tạo video thông qua công cụ dùng chung video_generate.

• Mô hình video mặc định: xai/grok-imagine-video
• Chế độ: văn bản thành video, ảnh thành video, tạo ảnh tham chiếu, chỉnh sửa video từ xa và mở rộng video từ xa
• Tỷ lệ khung hình: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• Độ phân giải: 480P, 720P
• Thời lượng: 1-15 giây cho tạo/ảnh thành video, 1-10 giây khi dùng vai trò reference_image, 2-10 giây cho mở rộng
• Tạo ảnh tham chiếu: đặt imageRoles thành reference_image cho mọi ảnh được cung cấp; xAI chấp nhận tối đa 7 ảnh như vậy
• Thời gian chờ thao tác mặc định: 600 giây trừ khi video_generate.timeoutMs hoặc agents.defaults.videoGenerationModel.timeoutMs được đặt

Để dùng xAI làm nhà cung cấp video mặc định:

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

Plugin xai được cung cấp sẵn đăng ký tạo ảnh thông qua công cụ dùng chung image_generate.

• Mô hình ảnh mặc định: xai/grok-imagine-image
• Mô hình bổ sung: xai/grok-imagine-image-quality
• Chế độ: văn bản thành ảnh và chỉnh sửa ảnh tham chiếu
• Đầu vào tham chiếu: một image hoặc tối đa năm images
• Tỷ lệ khung hình: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Độ phân giải: 1K, 2K
• Số lượng: tối đa 4 ảnh
• Thời gian chờ thao tác mặc định: 600 giây trừ khi image_generate.timeoutMs hoặc agents.defaults.imageGenerationModel.timeoutMs được đặt

OpenClaw yêu cầu xAI trả về ảnh dạng b64_json để media đã tạo có thể được lưu trữ và gửi qua đường dẫn tệp đính kèm kênh thông thường. Ảnh tham chiếu cục bộ được chuyển đổi thành data URL; tham chiếu http(s) từ xa được chuyển tiếp nguyên trạng.

Để dùng xAI làm nhà cung cấp ảnh mặc định:

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

Plugin xai đi kèm đăng ký chuyển văn bản thành giọng nói thông qua bề mặt nhà cung cấp tts dùng chung.

• Giọng nói: eve, ara, rex, sal, leo, una
• Giọng nói mặc định: eve
• Định dạng: mp3, wav, pcm, mulaw, alaw
• Ngôn ngữ: mã BCP-47 hoặc auto
• Tốc độ: ghi đè tốc độ gốc của nhà cung cấp
• Định dạng ghi chú thoại Opus gốc không được hỗ trợ

Để dùng xAI làm nhà cung cấp TTS mặc định:

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

Plugin xai đi kèm đăng ký chuyển giọng nói thành văn bản theo lô thông qua bề mặt phiên âm hiểu phương tiện của OpenClaw.

• Mô hình mặc định: grok-stt
• Endpoint: xAI REST /v1/stt
• Đường dẫn đầu vào: tải lên tệp âm thanh dạng multipart
• Được OpenClaw hỗ trợ ở mọi nơi phiên âm âm thanh đầu vào dùng tools.media.audio, bao gồm các đoạn kênh thoại Discord và tệp đính kèm âm thanh của kênh

Để bắt buộc dùng xAI cho phiên âm âm thanh đầu vào:

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

Ngôn ngữ có thể được cung cấp qua cấu hình phương tiện âm thanh dùng chung hoặc qua yêu cầu phiên âm theo từng lệnh gọi. Gợi ý prompt được bề mặt OpenClaw dùng chung chấp nhận, nhưng tích hợp xAI REST STT chỉ chuyển tiếp tệp, mô hình, và ngôn ngữ vì các trường đó ánh xạ rõ ràng tới endpoint xAI công khai hiện tại.

Plugin xai đi kèm cũng đăng ký một nhà cung cấp phiên âm thời gian thực cho âm thanh cuộc gọi thoại trực tiếp.

• Endpoint: xAI WebSocket wss://api.x.ai/v1/stt
• Mã hóa mặc định: mulaw
• Tần số lấy mẫu mặc định: 8000
• Phân đoạn kết thúc mặc định: 800ms
• Bản phiên âm tạm thời: bật theo mặc định

Luồng phương tiện Twilio của Voice Call gửi các khung âm thanh G.711 µ-law, nên nhà cung cấp xAI có thể chuyển tiếp trực tiếp các khung đó mà không cần chuyển mã:

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "xai",            providers: {              xai: {                apiKey: "${XAI_API_KEY}",                endpointingMs: 800,                language: "en",              },            },          },        },      },    },  },}

Cấu hình do nhà cung cấp sở hữu nằm dưới plugins.entries.voice-call.config.streaming.providers.xai. Các khóa được hỗ trợ là apiKey, baseUrl, sampleRate, encoding (pcm, mulaw, hoặc alaw), interimResults, endpointingMs, và language.

Plugin xAI đi kèm phơi bày x_search dưới dạng một công cụ OpenClaw để tìm kiếm nội dung X (trước đây là Twitter) qua Grok.

Đường dẫn cấu hình: 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 đi kèm phơi bày code_execution dưới dạng một công cụ OpenClaw để thực thi mã từ xa trong môi trường sandbox của xAI.

Đường dẫn cấu hình: plugins.entries.xai.config.codeExecution

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

• Xác thực xAI có thể dùng khóa API, biến môi trường, dự phòng cấu hình Plugin, hoặc OAuth với tài khoản xAI đủ điều kiện. OAuth dùng xác minh mã thiết bị mà không cần callback localhost. xAI quyết định tài khoản nào có thể nhận token API OAuth, và trang đồng ý có thể hiển thị Grok Build dù OpenClaw không yêu cầu ứng dụng Grok Build.
• OpenClaw hiện chưa phơi bày họ mô hình đa tác nhân của xAI. xAI phục vụ các mô hình này qua Responses API, nhưng chúng không chấp nhận công cụ phía máy khách hoặc công cụ tùy chỉnh được vòng lặp tác nhân dùng chung của OpenClaw sử dụng. Xem giới hạn đa tác nhân của xAI.
• Giọng nói xAI Realtime chưa được đăng ký làm nhà cung cấp OpenClaw. Nó cần một hợp đồng phiên giọng nói hai chiều khác với STT theo lô hoặc phiên âm phát trực tuyến.
• quality hình ảnh xAI, mask hình ảnh, và các tỷ lệ khung hình bổ sung chỉ dành cho gốc chưa được phơi bày cho đến khi công cụ image_generate dùng chung có các điều khiển tương ứng giữa các nhà cung cấp.

• OpenClaw tự động áp dụng các bản sửa tương thích lược đồ công cụ và lệnh gọi công cụ dành riêng cho xAI trên đường dẫn runner dùng chung.
• Yêu cầu xAI gốc mặc định tool_stream: true. Đặt agents.defaults.models["xai/<model>"].params.tool_stream thành false để tắt tính năng này.
• Wrapper xAI đi kèm loại bỏ các cờ lược đồ công cụ nghiêm ngặt không được hỗ trợ và khóa payload effort suy luận trước khi gửi yêu cầu xAI gốc. Chỉ grok-4.3 / grok-4.3-* quảng bá effort suy luận có thể cấu hình; tất cả các mô hình xAI có khả năng suy luận khác vẫn yêu cầu include: ["reasoning.encrypted_content"] để suy luận đã mã hóa trước đó có thể được phát lại ở các lượt tiếp theo.
• web_search, x_search, và code_execution được phơi bày dưới dạng công cụ OpenClaw. OpenClaw bật đúng công cụ tích hợp xAI cần thiết bên trong từng yêu cầu công cụ thay vì gắn mọi công cụ gốc vào từng lượt chat.
• Grok web_search đọc plugins.entries.xai.config.webSearch.baseUrl. x_search đọc plugins.entries.xai.config.xSearch.baseUrl, rồi dự phòng về URL cơ sở tìm kiếm web của Grok.
• x_search và code_execution do Plugin xAI đi kèm sở hữu thay vì được mã hóa cứng vào runtime mô hình lõi.
• code_execution là thực thi sandbox xAI từ xa, không phải exec cục bộ.