xAI

Nhà cung cấp tìm kiếm web grok tích hợp có thể dùng XAI_API_KEY hoặc khóa tìm kiếm web của Plugin:

openclaw config set tools.web.search.provider grok

Plugin xai tích hợp đă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ế độ: text-to-video, image-to-video, tạo reference-image, 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/video từ hình ảnh, 1-10 giây khi dùng vai trò reference_image, 2-10 giây cho mở rộng
• Tạo reference-image: đặt imageRoles thành reference_image cho mọi hình ảnh được cung cấp; xAI chấp nhận tối đa 7 hình ảnh như vậy

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

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

Plugin xai tích hợp đăng ký tạo hình ảnh thông qua công cụ dùng chung image_generate.

• Mô hình hình ảnh mặc định: xai/grok-imagine-image
• Mô hình bổ sung: xai/grok-imagine-image-pro
• Chế độ: text-to-image và chỉnh sửa reference-image
• Đầ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 hình ảnh

OpenClaw yêu cầu xAI trả về phản hồi hình ảnh b64_json để phương tiện được 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. Hình ảnh tham chiếu cục bộ được chuyển đổi thành URL dữ liệu; tham chiếu http(s) từ xa được truyền nguyên trạng.

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

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

Plugin xai tích hợp đăng ký text-to-speech thông qua bề mặt nhà cung cấp tts dùng chung.

• Giọng: eve, ara, rex, sal, leo, una
• Giọng 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: {          voiceId: "eve",        },      },    },  },}

Plugin xai tích hợp đăng ký speech-to-text 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: REST xAI /v1/stt
• Đường dẫn đầu vào: tải lên tệp âm thanh multipart
• Được OpenClaw hỗ trợ ở mọi nơi phiên âm âm thanh đến 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

Để buộc dùng xAI cho phiên âm âm thanh đến:

{  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 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 REST STT của xAI 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 tích hợp 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: WebSocket xAI wss://api.x.ai/v1/stt
• Mã hóa mặc định: mulaw
• Tần số lấy mẫu mặc định: 8000
• Endpointing mặc định: 800ms
• Bản chép lời tạm thời: được 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, vì vậy nhà cung cấp xAI có thể chuyển tiếp các khung đó trực tiếp 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 provider 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 được đóng gói sẵn cung cấp x_search làm công cụ OpenClaw để tìm kiếm nội dung X (trước đây là Twitter) thông 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 được đóng gói sẵn cung cấp code_execution làm 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",          },        },      },    },  },}

• Hiện nay xác thực chỉ dùng khóa API. Khóa API có thể được lưu trong hồ sơ xác thực xAI, biến môi trường, hoặc cấu hình plugin; OpenClaw chưa có luồng OAuth hoặc device-code của xAI.
• grok-4.20-multi-agent-experimental-beta-0304 không được hỗ trợ trên đường dẫn provider xAI thông thường vì nó yêu cầu bề mặt API upstream khác với transport xAI tiêu chuẩn của OpenClaw.
• Giọng nói xAI Realtime chưa được đăng ký làm provider 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 truyền phát.
• quality của ảnh xAI, mask của ảnh, và các tỷ lệ khung hình bổ sung chỉ dành riêng cho native chưa được cung cấp cho đến khi công cụ image_generate dùng chung có các điều khiển tương ứng trên nhiều provider.

• OpenClaw tự động áp dụng các bản sửa tương thích riêng cho xAI về schema công cụ và lệnh gọi công cụ trên đường dẫn runner dùng chung.
• Các yêu cầu xAI native mặc định là tool_stream: true. Đặt agents.defaults.models["xai/<model>"].params.tool_stream thành false để tắt tùy chọn này.
• Wrapper xAI được đóng gói sẵn loại bỏ các cờ schema công cụ strict không được hỗ trợ và các khóa payload reasoning trước khi gửi yêu cầu xAI native.
• web_search, x_search, và code_execution được cung cấp dưới dạng công cụ OpenClaw. OpenClaw bật đúng built-in xAI cụ thể cần thiết bên trong từng yêu cầu công cụ thay vì gắn tất cả công cụ native vào mọi lượt chat.
• Grok web_search đọc plugins.entries.xai.config.webSearch.baseUrl. x_search đọc plugins.entries.xai.config.xSearch.baseUrl, rồi fallback về URL cơ sở tìm kiếm web của Grok.
• x_search và code_execution thuộc sở hữu của Plugin xAI được đóng gói sẵn thay vì được mã hóa cứng vào runtime model lõi.
• code_execution là thực thi sandbox xAI từ xa, không phải exec cục bộ.