xAI

Вбудований провайдер веб-пошуку grok віддає перевагу xAI OAuth, а потім повертається до XAI_API_KEY або ключа веб-пошуку 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 таких зображень
• Тайм-аут операції за замовчуванням: 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 зображень
• Тайм-аут операції за замовчуванням: 600 секунд, якщо не встановлено image_generate.timeoutMs або agents.defaults.imageGenerationModel.timeoutMs

OpenClaw запитує в xAI відповіді зображень b64_json, щоб згенеровані медіа могли зберігатися і доставлятися через звичайний шлях вкладень каналу. Локальні референсні зображення перетворюються на 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 для віддаленого виконання коду в середовищі sandbox xAI.

Шлях конфігурації: plugins.entries.xai.config.codeExecution

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

• Автентифікація xAI може використовувати ключ API, змінну середовища, резервну конфігурацію Plugin або OAuth з відповідним обліковим записом xAI. OAuth використовує перевірку за кодом пристрою без зворотного виклику localhost. xAI визначає, які облікові записи можуть отримувати OAuth API tokens, а сторінка згоди може показувати Grok Build, хоча OpenClaw не потребує застосунку Grok Build.
• OpenClaw наразі не надає сімейство багатоагентних моделей xAI. xAI обслуговує ці моделі через Responses API, але вони не приймають клієнтські або користувацькі інструменти, які використовуються спільним циклом агента OpenClaw. Див. обмеження багатоагентних моделей xAI.
• Голос xAI Realtime ще не зареєстровано як провайдера OpenClaw. Він потребує іншого двонапрямного контракту голосового сеансу, ніж пакетний STT або потокова транскрипція.
• quality зображень xAI, mask зображень і додаткові суто власні співвідношення сторін не доступні, доки спільний інструмент image_generate не матиме відповідних міжпровайдерних елементів керування.

• OpenClaw автоматично застосовує сумісні виправлення, специфічні для xAI, для схем інструментів і викликів інструментів у спільному шляху runner.
• Нативні запити xAI за замовчуванням мають tool_stream: true. Установіть agents.defaults.models["xai/<model>"].params.tool_stream на false, щоб вимкнути це.
• Вбудована обгортка xAI видаляє непідтримувані прапорці суворої схеми інструментів і ключі корисного навантаження reasoning effort перед надсиланням нативних запитів xAI. Лише grok-4.3 / grok-4.3-* оголошують налаштовуване зусилля reasoning; усі інші моделі xAI з можливістю reasoning все одно запитують include: ["reasoning.encrypted_content"], щоб попередній зашифрований reasoning можна було відтворити в наступних ходах.
• web_search, x_search і code_execution надаються як інструменти OpenClaw. OpenClaw вмикає конкретний вбудований інструмент xAI, який потрібен у кожному запиті інструмента, замість додавання всіх нативних інструментів до кожного ходу чату.
• Grok web_search читає plugins.entries.xai.config.webSearch.baseUrl. x_search читає plugins.entries.xai.config.xSearch.baseUrl, а потім повертається до базового URL вебпошуку Grok.
• x_search і code_execution належать вбудованому Plugin xAI, а не жорстко закодовані в основному runtime моделей.
• code_execution — це віддалене виконання в sandbox xAI, а не локальний exec.