Перейти до основного вмісту
OpenClaw постачається з вбудованим Plugin провайдера xai для моделей Grok. Для більшості користувачів рекомендований шлях — Grok OAuth з відповідною підпискою SuperGrok або X Premium. OpenClaw залишається локально-орієнтованим: Gateway, конфігурація, маршрутизація та інструменти працюють на вашому комп’ютері, тоді як запити до моделей Grok автентифікуються через xAI і надсилаються до API xAI. OAuth не потребує ключа API xAI і не потребує застосунку Grok Build. xAI усе ще може показувати Grok Build на екрані згоди, оскільки OpenClaw використовує спільний OAuth-клієнт xAI.

​
Виберіть шлях налаштування

Використовуйте шлях, що відповідає стану вашої інсталяції OpenClaw:
1

Нова інсталяція OpenClaw

Запустіть початкове налаштування з установленням демона, коли налаштовуєте новий локальний Gateway, а потім виберіть варіант xAI/Grok OAuth на кроці моделі/автентифікації:
openclaw onboard --install-daemon
На VPS або через SSH виберіть xAI OAuth напряму; OpenClaw використовує перевірку через код пристрою і не потребує callback на localhost:
openclaw onboard --install-daemon --auth-choice xai-oauth
OAuth не потребує ключа API xAI. OpenClaw не потребує застосунку Grok Build. xAI усе ще може позначати застосунок згоди як Grok Build, оскільки OpenClaw використовує спільний OAuth-клієнт xAI.
2

Наявна інсталяція OpenClaw

Якщо OpenClaw уже налаштовано, увійдіть лише в xAI. Не запускайте повне початкове налаштування повторно і не перевстановлюйте демон лише для підключення Grok:
openclaw models auth login --provider xai --method oauth
Щоб зробити Grok моделлю за замовчуванням після входу, застосуйте це окремо:
openclaw models set xai/grok-4.3
Повторно запускайте повне початкове налаштування лише якщо ви навмисно хочете змінити Gateway, демон, канал, робочу область або інші параметри налаштування.
3

Шлях із ключем API

Налаштування з ключем API і надалі працює для ключів xAI Console та для медійних поверхонь, які потребують конфігурації провайдера на основі ключа:
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
4

Виберіть модель

{
  agents: { defaults: { model: { primary: "xai/grok-4.3" } } },
}
OpenClaw використовує xAI Responses API як вбудований транспорт xAI. Ті самі облікові дані з openclaw models auth login --provider xai --method oauth або openclaw models auth login --provider xai --method api-key також можуть забезпечувати першокласні web_search, x_search, віддалене code_execution та генерацію зображень/відео xAI. Мовлення і транскрипція наразі потребують XAI_API_KEY або конфігурації провайдера. web_search на базі Grok віддає перевагу xAI OAuth і повертається до XAI_API_KEY або конфігурації веб-пошуку Plugin. Якщо ви зберігаєте ключ xAI у plugins.entries.xai.config.webSearch.apiKey, вбудований провайдер моделей xAI також повторно використовує цей ключ як резервний. Установіть plugins.entries.xai.config.webSearch.baseUrl, щоб маршрутизувати Grok web_search і, за замовчуванням, x_search через операторський проксі xAI Responses. Налаштування code_execution розміщені в plugins.entries.xai.config.codeExecution.

​
Усунення проблем OAuth

  • Для SSH, Docker, VPS або інших віддалених налаштувань використовуйте openclaw models auth login --provider xai --method oauth; xAI OAuth використовує перевірку через код пристрою замість callback на localhost.
  • Якщо вхід успішний, але Grok не є моделлю за замовчуванням, виконайте openclaw models set xai/grok-4.3.
  • Щоб переглянути збережені профілі автентифікації xAI, виконайте: 
    openclaw models auth list --provider xai
openclaw models status
  • xAI вирішує, які облікові записи можуть отримувати токени API через OAuth. Якщо обліковий запис не відповідає вимогам, спробуйте шлях із ключем API або перевірте підписку на стороні xAI.
Використовуйте xai-oauth, коли входите з SSH, Docker або VPS. OpenClaw виводить URL xAI і короткий код; завершіть вхід у будь-якому локальному браузері, поки віддалений процес опитує xAI щодо завершеного обміну токена.

​
Вбудований каталог

OpenClaw містить поточні чат-моделі xAI одразу з коробки, впорядковані від найновіших до найстаріших у вибірниках моделей:
РодинаID моделей
Grok Build 0.1grok-build-0.1
Grok 4.3grok-4.3
Grok 4.20 Betagrok-4.20-beta-latest-reasoning, grok-4.20-beta-latest-non-reasoning
Plugin і надалі forward-resolves старіші слаги Grok 3, Grok 4, Grok 4 Fast, Grok 4.1 Fast і Grok Code для наявних конфігурацій. Офіційні псевдоніми Grok Code Fast нормалізуються до grok-build-0.1; OpenClaw більше не показує інші вилучені вищестоящі слаги у вибірковому каталозі.
Використовуйте grok-4.3 для загального чату та grok-build-0.1 для робочих навантажень, орієнтованих на збірку/кодування, якщо вам явно не потрібен beta-псевдонім Grok 4.20.

​
Покриття можливостей OpenClaw

Вбудований Plugin зіставляє поточну публічну поверхню API xAI зі спільними контрактами провайдера та інструментів OpenClaw. Можливості, які не вписуються у спільний контракт (наприклад, потоковий TTS і голос у реальному часі), не експонуються - див. таблицю нижче.
Можливість xAIПоверхня OpenClawСтан
Чат / Responsesпровайдер моделі xai/<model>Так
Серверний веб-пошукпровайдер web_search grokТак
Серверний пошук Xінструмент x_searchТак
Серверне виконання кодуінструмент code_executionТак
Зображенняimage_generateТак
Відеоvideo_generateТак
Пакетний text-to-speechmessages.tts.provider: "xai" / ttsТак
Потоковий TTS-Не експонується; контракт TTS OpenClaw повертає повні аудіобуфери
Пакетний speech-to-texttools.media.audio / розуміння медіаТак
Потоковий speech-to-textVoice Call streaming.provider: "xai"Так
Голос у реальному часі-Ще не експонується; інший контракт сесії/WebSocket
Файли / пакетиЛише сумісність із Generic model APIНе першокласний інструмент OpenClaw
OpenClaw використовує REST API xAI для зображень/відео/TTS/STT для генерації медіа, мовлення і пакетної транскрипції, потоковий STT WebSocket xAI для живої транскрипції голосових викликів і Responses API для моделей, пошуку та інструментів виконання коду. Можливості, яким потрібні інші контракти OpenClaw, як-от сесії голосу в реальному часі, задокументовані тут як вищестоящі можливості, а не прихована поведінка Plugin.

​
Зіставлення швидкого режиму

/fast on або agents.defaults.models["xai/<model>"].params.fastMode: true переписує нативні запити xAI так:
Вихідна модельЦіль швидкого режиму
grok-3grok-3-fast
grok-3-minigrok-3-mini-fast
grok-4grok-4-fast
grok-4-0709grok-4-fast

​
Застарілі псевдоніми сумісності

Застарілі псевдоніми й надалі нормалізуються до канонічних вбудованих ID:
Застарілий псевдонімКанонічний ID
grok-code-fast-1grok-build-0.1
grok-code-fastgrok-build-0.1
grok-code-fast-1-0825grok-build-0.1
grok-4-fast-reasoninggrok-4-fast
grok-4-1-fast-reasoninggrok-4-1-fast
grok-4.20-reasoninggrok-4.20-beta-latest-reasoning
grok-4.20-non-reasoninggrok-4.20-beta-latest-non-reasoning

​
Можливості

Вбудований провайдер веб-пошуку grok віддає перевагу xAI OAuth, а потім повертається до XAI_API_KEY або ключа веб-пошуку Plugin:
openclaw models auth login --provider xai --method oauth
openclaw 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
Локальні відеобуфери не приймаються. Використовуйте віддалені URL http(s) для вхідних даних редагування/розширення відео. Image-to-video приймає локальні буфери зображень, оскільки OpenClaw може закодувати їх як data URL для xAI.
Щоб використовувати xAI як провайдера відео за замовчуванням:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "xai/grok-imagine-video",
      },
    },
  },
}
Див. Генерація відео щодо спільних параметрів інструмента, вибору провайдера та поведінки failover.
Вбудований 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",
      },
    },
  },
}
xAI також документує quality, mask, user і додаткові власні співвідношення сторін, як-от 1:2, 2:1, 9:20 і 20:9. Наразі OpenClaw передає лише спільні міжпровайдерні елементи керування зображеннями; непідтримувані суто власні регулятори навмисно не доступні через image_generate.
Вбудований 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",
        },
      },
    },
  },
}
OpenClaw використовує пакетну кінцеву точку xAI /v1/tts. xAI також пропонує потокове TTS через WebSocket, але контракт мовленнєвого провайдера OpenClaw наразі очікує повний аудіобуфер перед доставкою відповіді.
Вбудований 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.
Цей потоковий провайдер призначений для шляху транскрипції Voice Call у реальному часі. Голос Discord наразі записує короткі сегменти й натомість використовує пакетний шлях транскрипції tools.media.audio.
Вбудований Plugin xAI надає x_search як інструмент OpenClaw для пошуку вмісту X (раніше Twitter) через Grok.Шлях конфігурації: plugins.entries.xai.config.xSearch
КлючТипЗа замовчуваннямОпис
enabledboolean-Увімкнути або вимкнути x_search
modelstringgrok-4-1-fastМодель, що використовується для запитів x_search
baseUrlstring-Перевизначення базового URL xAI Responses
inlineCitationsboolean-Додавати вбудовані цитування в результати
maxTurnsnumber-Максимальна кількість ходів розмови
timeoutSecondsnumber-Тайм-аут запиту в секундах
cacheTtlMinutesnumber-Час життя кешу в хвилинах
{
  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
КлючТипЗа замовчуваннямОпис
enabledbooleantrue (якщо ключ доступний)Увімкнути або вимкнути виконання коду
modelstringgrok-4-1-fastМодель, що використовується для запитів виконання коду
maxTurnsnumber-Максимальна кількість ходів розмови
timeoutSecondsnumber-Тайм-аут запиту в секундах
Це віддалене виконання в sandbox xAI, а не локальний exec.
{
  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.

​
Тестування наживо

Медіашляхи xAI покриті модульними тестами й opt-in наборами тестів наживо. Експортуйте XAI_API_KEY у середовищі процесу перед запуском живих проб. 
pnpm test extensions/xai
OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 pnpm test:live -- extensions/xai/xai.live.test.ts
OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 OPENCLAW_LIVE_IMAGE_GENERATION_PROVIDERS=xai pnpm test:live -- test/image-generation.runtime.live.test.ts
Специфічний для провайдера файл тестів наживо синтезує звичайне TTS, телефонно-дружнє PCM TTS, транскрибує аудіо через пакетний STT xAI, транслює той самий PCM через xAI STT у реальному часі, генерує результат text-to-image і редагує еталонне зображення. Спільний файл тестів зображень наживо перевіряє того самого провайдера xAI через шлях вибору runtime, резервного варіанта, нормалізації та медіавкладень OpenClaw.

​
Пов’язане

Вибір моделі

Вибір провайдерів, посилань на моделі та поведінки перемикання після збою.

Генерація відео

Спільні параметри відеоінструмента та вибір провайдера.

Усі провайдери

Ширший огляд провайдерів.

Усунення несправностей

Поширені проблеми та виправлення.