xAI

Nhà cung cấp tìm kiếm web grok tích hợp sẵn ưu tiên xAI OAuth, sau đó dùng dự phòng 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 tích hợp sẵn đăng ký tính năng tạo video thông qua công cụ dùng chung video_generate.

• Mô hình mặc định: xai/grok-imagine-video
• Mô hình bổ sung: xai/grok-imagine-video-1.5
• Các chế độ cổ điển: chuyển văn bản thành video, chuyển hình ảnh thành video, tạo từ hình ảnh tham chiếu, chỉnh sửa video từ xa và mở rộng video từ xa
• Chế độ Video 1.5: chỉ chuyển hình ảnh thành video, với đúng một hình ảnh khung hình đầu tiên
• Tỷ lệ khung hình: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3; chế độ chuyển hình ảnh thành video cổ điển và Video 1.5 kế thừa tỷ lệ của hình ảnh nguồn khi bị bỏ qua
• Độ phân giải: cổ điển 480P/720P; Video 1.5 cũng hỗ trợ 1080P; tất cả chế độ tạo đều mặc định là 480P
• Thời lượng: 1-15 giây cho tạo/chuyển hình ảnh thành video, 1-10 giây khi sử dụng vai trò reference_image cổ điển, 2-10 giây cho tính năng mở rộng cổ điển
• Tạo từ hình ảnh tham chiếu: đặ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
• Chỉnh sửa/mở rộng video kế thừa tỷ lệ khung hình và độ phân giải của video đầu vào; các thao tác này không chấp nhận ghi đè thông số hình học
• Thời gian chờ thao tác mặc định: 600 giây, trừ khi đặt video_generate.timeoutMs hoặc agents.defaults.videoGenerationModel.timeoutMs

Video 1.5 cũng nhận dạng các mã định danh grok-imagine-video-1.5-preview và grok-imagine-video-1.5-2026-05-30 của xAI. OpenClaw chuyển tiếp nguyên vẹn mã định danh đã chọn, nhưng áp dụng cùng quy tắc xác thực chỉ dành cho hình ảnh.

Để 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 sẵn đăng ký tính năng 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-quality
• Chế độ: văn bản thành hình ảnh và chỉnh sửa bằng hình ảnh tham chiếu
• Đầu vào tham chiếu: một image hoặc tối đa ba images
• Tỷ lệ khung hình: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20
• Độ phân giải: 1K, 2K
• Số lượng: tối đa 4 hình ảnh
• Thời gian chờ thao tác mặc định: 600 giây, trừ khi đã đặt image_generate.timeoutMs hoặc agents.defaults.imageGenerationModel.timeoutMs

OpenClaw yêu cầu xAI trả về phản hồi hình ảnh b64_json để nội dung phương tiện được tạo có thể được lưu trữ và phân phối qua luồng đính kèm thông thường của kênh. 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 chuyển tiếp 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 đi kèm đăng ký chức năng 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: danh mục trực tiếp có xác thực từ xAI; liệt kê bằng openclaw infer tts voices --provider xai
• Giọng nói dự phòng ngoại tuyến: ara, eve, leo, rex, sal
• Giọng nói mặc định: eve
• ID giọng nói tùy chỉnh của tài khoản vẫn được chuyển tiếp ngay cả khi không có trong phản hồi danh mục tích hợp sẵn
• Đị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
• Không hỗ trợ định dạng tin nhắn thoại Opus gốc

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

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

Plugin xai đi kèm đăng ký chức năng 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 nội dung phương tiện của OpenClaw.

• Điểm cuối: xAI REST /v1/stt
• Đường dẫn đầu vào: tải tệp âm thanh lên theo dạng multipart
• Lựa chọn mô hình: xAI chọn mô hình phiên âm nội bộ; điểm cuối không có bộ chọn mô hình
• Được sử dụng ở mọi nơi mà chức năng phiên âm âm thanh đầu vào đọc tools.media.audio, bao gồm các đoạn trong kênh thoại Discord và tệp đính kèm âm thanh của kênh

Để buộc sử dụng xAI cho việc phiên âm âm thanh đầu vào:

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",          },        ],      },    },  },}

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

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.

• Điểm cuối: xAI WebSocket wss://api.x.ai/v1/stt
• Kiểu mã hóa mặc định: mulaw
• Tần số lấy mẫu mặc định: 8000
• Phát hiện điểm kết thúc mặc định: 800ms
• Bản phiên âm 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 mu-law, vì vậy nhà cung cấp xAI chuyển tiếp trực tiếp các khung đó mà không 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 thuộc quyền sở hữu của nhà cung cấp nằm tại plugins.entries.voice-call.config.streaming.providers.xai. Các khóa được hỗ trợ gồm apiKey, baseUrl, sampleRate, encoding (pcm, mulaw hoặc alaw), interimResults, endpointingMs và language.

Plugin xAI đi kèm cung cấp x_search dưới dạng một công cụ OpenClaw để tìm kiếm nội dung trên 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.3",            baseUrl: "https://api.x.ai/v1",            inlineCitations: true,          },        },      },    },  },}

Plugin xAI đi kèm cung cấp code_execution dưới dạng một công cụ OpenClaw để thực thi mã từ xa trong môi trường hộp cát 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.3",          },        },      },    },  },}

• Xác thực xAI có thể sử dụng khóa API, biến môi trường, phương án dự phòng từ cấu hình Plugin hoặc OAuth với tài khoản xAI đủ điều kiện. OAuth sử dụng xác minh bằng mã thiết bị mà không cần gọi lại localhost. xAI quyết định tài khoản nào có thể nhận mã thông báo API OAuth và trang đồng ý có thể hiển thị Grok Build mặc dù OpenClaw không yêu cầu ứng dụng Grok Build.
• Hiện tại OpenClaw không cung cấp dòng 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ác 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 các giới hạn về đa tác nhân của xAI.
• Giọng nói thời gian thực của xAI chưa được đăng ký làm nhà cung cấp OpenClaw. Tính năng này cần một hợp đồng phiên thoại hai chiều khác với STT theo lô hoặc phiên âm truyền trực tuyến.
• quality hình ảnh, mask hình ảnh và tỷ lệ khung hình auto gốc của xAI 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 giữa các nhà cung cấp.

• OpenClaw tự động áp dụng các bản sửa tương thích dành riêng cho xAI về lược đồ công cụ và lệnh gọi công cụ trên đường dẫn trình chạy dùng chung.
• Các yêu cầu xAI gốc mặc định dùng tool_stream: true. Đặt agents.defaults.models["xai/<model>"].params.tool_stream thành false để tắt.
• Trình bao bọc xAI đi kèm loại bỏ các giới hạn lược đồ đếm phần tử không được hỗ trợ và các khóa tải trọng effort suy luận không được hỗ trợ trước khi gửi yêu cầu xAI gốc. Grok 4.5 hỗ trợ mức nỗ lực thấp, trung bình và cao (mặc định là cao). Grok 4.3 hỗ trợ không có, thấp, trung bình và cao (mặc định là thấp). Các mô hình xAI khác có khả năng suy luận không cung cấp điều khiển mức nỗ lực có thể cấu hình, nhưng vẫn yêu cầu include: ["reasoning.encrypted_content"] để nội dung suy luận đã mã hóa trước đó có thể được phát lại trong các lượt tiếp theo.
• web_search, x_search và code_execution được cung cấp dưới dạng các công cụ OpenClaw. OpenClaw chỉ gắn công cụ tích hợp sẵn cụ thể của xAI mà mỗi công cụ cần vào yêu cầu của công cụ đó, thay vì gắn mọi công cụ gốc vào mọi lượt trò chuyện.
• web_search của Grok đọc plugins.entries.xai.config.webSearch.baseUrl. x_search đọc plugins.entries.xai.config.xSearch.baseUrl, sau đó dùng URL cơ sở tìm kiếm web của Grok làm phương án dự phòng.
• x_search và code_execution thuộc quyền sở hữu của Plugin xAI đi kèm, thay vì được mã hóa cứng trong môi trường chạy mô hình lõi.
• code_execution là hoạt động thực thi từ xa trong hộp cát xAI, không phải exec cục bộ.