xAI

Вбудований провайдер вебпошуку grok може використовувати XAI_API_KEY або ключ вебпошуку Plugin:

openclaw config set tools.web.search.provider grok

Вбудований Plugin xai реєструє генерацію відео через спільний інструмент video_generate.

• Стандартна модель відео: xai/grok-imagine-video
• Режими: текст-у-відео, зображення-у-відео, генерація за референсним зображенням, віддалене редагування відео та віддалене розширення відео
• Співвідношення сторін: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• Роздільні здатності: 480P, 720P
• Тривалість: 1-15 секунд для генерації/зображення-у-відео, 1-10 секунд під час використання ролей reference_image, 2-10 секунд для розширення
• Генерація за референсним зображенням: задайте imageRoles як reference_image для кожного наданого зображення; xAI приймає до 7 таких зображень

Щоб використовувати xAI як стандартного провайдера відео:

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

Вбудований Plugin xai реєструє генерацію зображень через спільний інструмент image_generate.

• Стандартна модель зображень: xai/grok-imagine-image
• Додаткова модель: xai/grok-imagine-image-pro
• Режими: текст-у-зображення та редагування за референсним зображенням
• Референсні вхідні дані: одне image або до п’яти images
• Співвідношення сторін: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Роздільні здатності: 1K, 2K
• Кількість: до 4 зображень

OpenClaw запитує в xAI відповіді зображень b64_json, щоб згенеровані медіа можна було зберігати й доставляти через звичайний шлях вкладень каналу. Локальні референсні зображення перетворюються на data URL; віддалені референси http(s) передаються напряму.

Щоб використовувати xAI як стандартного провайдера зображень:

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

Вбудований Plugin xai реєструє text-to-speech через спільну поверхню провайдера 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: {          voiceId: "eve",        },      },    },  },}

Вбудований Plugin xai реєструє пакетний speech-to-text через поверхню транскрипції розуміння медіа 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",          },        ],      },    },  },}

Мову можна надати через спільну конфігурацію аудіомедіа або в запиті транскрипції для окремого виклику. Підказки prompt приймаються спільною поверхнею OpenClaw, але REST-інтеграція STT xAI передає лише файл, модель і мову, бо вони чітко відповідають поточному публічному endpoint xAI.

Вбудований Plugin xai також реєструє провайдера транскрипції в реальному часі для живого аудіо голосових викликів.

• Endpoint: 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 для віддаленого виконання коду в пісочниці xAI.

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

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

• Автентифікація сьогодні підтримує лише API-ключ. API-ключ можна зберігати в профілі автентифікації xAI, змінній середовища або конфігурації plugin; OAuth xAI або потоку device-code в OpenClaw поки немає.
• grok-4.20-multi-agent-experimental-beta-0304 не підтримується у звичайному шляху провайдера xAI, оскільки потребує іншої поверхні upstream 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 вилучає непідтримувані прапорці строгих схем інструментів і ключі payload reasoning перед надсиланням нативних запитів xAI.
• 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, а не жорстко закодовані в core runtime моделей.
• code_execution — це віддалене виконання в пісочниці xAI, а не локальний exec.