xAI

Вбудований провайдер вебпошуку grok надає перевагу OAuth xAI, а потім використовує 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
• Додаткова модель: xai/grok-imagine-video-1.5
• Класичні режими: перетворення тексту на відео, зображення на відео, генерація за еталонним зображенням, віддалене редагування відео та віддалене продовження відео
• Режим Video 1.5: лише перетворення зображення на відео, із рівно одним зображенням першого кадру
• Співвідношення сторін: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3; у класичному режимі та Video 1.5 перетворення зображення на відео успадковує співвідношення сторін вихідного зображення, якщо його не вказано
• Роздільна здатність: у класичному режимі 480P/720P; Video 1.5 також підтримує 1080P; у всіх режимах генерації за замовчуванням використовується 480P
• Тривалість: 1–15 секунд для генерації/перетворення зображення на відео, 1–10 секунд за використання класичних ролей reference_image, 2–10 секунд для класичного продовження
• Генерація за еталонним зображенням: установіть imageRoles у значення reference_image для кожного наданого зображення; xAI приймає до 7 таких зображень
• Редагування/продовження відео успадковує співвідношення сторін і роздільну здатність вхідного відео; ці операції не приймають перевизначень геометрії
• Стандартний час очікування операції: 600 секунд, якщо не встановлено video_generate.timeoutMs або agents.defaults.videoGenerationModel.timeoutMs

Video 1.5 також розпізнає ідентифікатори xAI grok-imagine-video-1.5-preview і grok-imagine-video-1.5-2026-05-30. OpenClaw передає вибраний ідентифікатор без змін, але застосовує таку саму перевірку, що дозволяє лише зображення.

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

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

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

• Модель зображень за замовчуванням: xai/grok-imagine-image
• Додаткова модель: xai/grok-imagine-image-quality
• Режими: перетворення тексту на зображення та редагування еталонного зображення
• Еталонні вхідні дані: одне image або до трьох images
• Співвідношення сторін: 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
• Роздільна здатність: 1K, 2K
• Кількість: до 4 зображень
• Стандартний час очікування операції: 600 секунд, якщо не задано image_generate.timeoutMs або agents.defaults.imageGenerationModel.timeoutMs

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

Щоб використовувати xAI як постачальника зображень за замовчуванням:

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

Вбудований plugin xai реєструє синтез мовлення через спільну поверхню постачальника tts.

• Голоси: автентифікований актуальний каталог від xAI; перегляньте його за допомогою openclaw infer tts voices --provider xai
• Резервні офлайн-голоси: ara, eve, leo, rex, sal
• Голос за замовчуванням: eve
• Ідентифікатори власних голосів облікового запису передаються, навіть якщо їх немає у відповіді вбудованого каталогу
• Формати: mp3, wav, pcm, mulaw, alaw
• Мова: код BCP-47 або auto
• Швидкість: перевизначення швидкості засобами постачальника
• Власний формат голосових нотаток Opus не підтримується

Щоб використовувати xAI як постачальника TTS за замовчуванням:

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

Вбудований plugin xai реєструє пакетне розпізнавання мовлення через поверхню транскрибування для аналізу медіа в OpenClaw.

• Кінцева точка: xAI REST /v1/stt
• Шлях вхідних даних: завантаження аудіофайлу як multipart
• Вибір моделі: xAI вибирає модель транскрибування внутрішньо; кінцева точка не має селектора моделі
• Використовується всюди, де транскрибування вхідного аудіо читає tools.media.audio, зокрема для сегментів голосових каналів Discord і аудіовкладень каналів

Щоб примусово використовувати xAI для транскрибування вхідного аудіо:

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

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

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

• Кінцева точка: xAI WebSocket wss://api.x.ai/v1/stt
• Кодування за замовчуванням: mulaw
• Частота дискретизації за замовчуванням: 8000
• Визначення кінця мовлення за замовчуванням: 800ms
• Проміжні транскрипції: увімкнені за замовчуванням

Медіапотік Twilio для Voice Call надсилає аудіокадри G.711 mu-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.3",            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.3",          },        },      },    },  },}

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

• OpenClaw автоматично застосовує виправлення сумісності схем інструментів і викликів інструментів, специфічні для xAI, у спільному шляху виконавця.
• Власні запити xAI за замовчуванням використовують tool_stream: true. Установіть agents.defaults.models["xai/<model>"].params.tool_stream у false, щоб вимкнути це.
• Вбудована обгортка xAI видаляє непідтримувані обмеження кількості елементів у схемі та непідтримувані ключі корисного навантаження рівня зусиль міркування перед надсиланням власних запитів xAI. Grok 4.5 підтримує низький, середній і високий рівні зусиль (за замовчуванням — високий). Grok 4.3 підтримує відсутній, низький, середній і високий рівні зусиль (за замовчуванням — низький). Інші моделі xAI зі здатністю до міркування не надають налаштовуваного керування рівнем зусиль, але все одно запитують include: ["reasoning.encrypted_content"], щоб попередні зашифровані міркування можна було повторно використати в наступних ходах.
• 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, а не жорстко закодовані в основному середовищі виконання моделей.
• code_execution — це віддалене виконання в ізольованому середовищі xAI, а не локальний exec.