xai для моделей Grok.
Рекомендуемый способ — Grok OAuth с подходящей подпиской SuperGrok или X Premium.
Gateway, конфигурация, маршрутизация и инструменты остаются локальными; только запросы
Grok отправляются в API xAI.
Для OAuth не требуется API-ключ xAI или приложение Grok Build. xAI всё равно может
показывать Grok Build на экране согласия, поскольку OpenClaw использует общий
OAuth-клиент xAI.
Настройка
1
Новая установка
Запустите первоначальную настройку с установкой демона, затем на этапе
выбора модели и способа аутентификации выберите xAI/Grok OAuth:На VPS или при подключении по SSH выберите xAI OAuth напрямую; этот способ
использует проверку по коду устройства и не требует обратного вызова localhost:
2
Существующая установка
Войдите только в xAI; не запускайте полную первоначальную настройку повторно
лишь для подключения Grok:Отдельно назначьте Grok моделью по умолчанию:Повторно запускайте полную первоначальную настройку, только если намеренно
хотите изменить Gateway, демон, канал, рабочую область или другие параметры настройки.
3
Вариант с API-ключом
Настройка с API-ключом по-прежнему работает для ключей xAI Console и
мультимедийных интерфейсов, которым требуется конфигурация провайдера с ключом:
4
Выбор модели
OpenClaw использует xAI Responses API как встроенный транспорт xAI. Те же
учётные данные из
openclaw models auth login --provider xai --method oauth или
--method api-key также обеспечивают работу web_search (идентификатор провайдера grok), x_search,
code_execution, синтеза и транскрибирования речи, а также генерации изображений и видео xAI. Если
сохранить ключ xAI в plugins.entries.xai.config.webSearch.apiKey,
встроенный провайдер моделей xAI также использует его как резервный вариант.Устранение неполадок OAuth
-
Для SSH, Docker, VPS и других удалённых сред используйте
openclaw models auth login --provider xai --method oauth; этот способ использует проверку по коду устройства, а не обратный вызов localhost. -
Если вход выполнен успешно, но Grok не является моделью по умолчанию, выполните
openclaw models set xai/grok-4.3. -
Просмотрите сохранённые профили аутентификации xAI:
- xAI определяет, какие учётные записи могут получать API-токены OAuth. Если учётная запись не соответствует требованиям, используйте вариант с API-ключом или проверьте подписку на стороне xAI.
Встроенный каталог
Идентификаторы, доступные в средствах выбора моделей. Плагин по-прежнему распознаёт старые идентификаторы Grok 3, Grok 4, Grok 4 Fast, Grok 4.1 Fast и Grok Code для существующих конфигураций; см. совместимость с устаревшими версиями и изменяемые псевдонимы.Поддерживаемые возможности
Встроенный плагин сопоставляет поддерживаемые API xAI с общими контрактами провайдеров и инструментов OpenClaw. Возможности, которые не соответствуют общему контракту, перечислены ниже или в разделе известных ограничений.OpenClaw использует REST API xAI для изображений, видео, TTS и STT при генерации мультимедиа и
пакетном транскрибировании, потоковый WebSocket STT xAI для транскрибирования
голосовых вызовов в реальном времени, WebSocket Grok Voice Agent от xAI для сеансов Talk
в реальном времени и Responses API для чата, поиска и инструментов выполнения кода.
Совместимость с устаревшим быстрым режимом
/fast on или agents.defaults.models["xai/<model>"].params.fastMode: true
по-прежнему преобразует старые конфигурации xAI следующим образом. Эти целевые идентификаторы
сохраняются только для совместимости; для новых конфигураций используйте текущие
доступные для выбора модели.
Совместимость с устаревшими версиями и изменяемые псевдонимы
Старые псевдонимы нормализуются следующим образом:
Датированные идентификаторы 0309 являются доступными для выбора записями каталога. OpenClaw передаёт все остальные
текущие псевдонимы Grok 4.20 без изменений, чтобы xAI сохраняла контроль над семантикой стабильных,
новейших, бета-, экспериментальных и датированных псевдонимов. Глобальный псевдоним
grok-latest
также сохраняется без изменений.
xAI прекратила поддержку следующих точных идентификаторов. OpenClaw сохраняет их как скрытые строки
совместимости для выпущенных конфигураций с ограничениями и ценами их текущих
целей перенаправления:
openclaw doctor --fix обновляет сохранённые значения по умолчанию для серверных инструментов xAI и
устаревший идентификатор качества изображений, удаляет неактуальные сгенерированные строки каталога и исправляет
устаревшие метаданные контекста в активных строках 4.20. Она не закрепляет активные псевдонимы
4.20 beta-latest за датированным снимком.
Возможности
Веб-поиск
Веб-поиск
Встроенный провайдер веб-поиска
grok предпочитает xAI OAuth, а затем использует
XAI_API_KEY или ключ веб-поиска плагина как резервный вариант:Генерация видео
Генерация видео
Встроенный плагин
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
grok-imagine-video-1.5-preview и
grok-imagine-video-1.5-2026-05-30. OpenClaw передаёт выбранный
идентификатор без изменений, но применяет ту же проверку, допускающую только изображения.Чтобы использовать xAI как провайдера видео по умолчанию:Общие параметры инструмента, выбор провайдера и поведение при переключении
на резервный вариант описаны в разделе Генерация видео.
Генерация изображений
Генерация изображений
Встроенный плагин
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
b64_json, чтобы созданные медиафайлы можно было
сохранять и доставлять через обычный путь вложений канала. Локальные
референсные изображения преобразуются в URL-адреса данных; удалённые ссылки http(s)
передаются без изменений.Чтобы использовать xAI как поставщика изображений по умолчанию:В документации xAI также указаны
quality, mask, user и соотношение сторон auto.
Сейчас OpenClaw передаёт только общие для разных поставщиков параметры управления изображениями;
эти специфичные для xAI параметры недоступны через image_generate.Преобразование текста в речь
Преобразование текста в речь
Встроенный плагин
xai регистрирует преобразование текста в речь через общий
интерфейс поставщика tts.- Голоса: аутентифицированный актуальный каталог xAI; выведите его с помощью
openclaw infer tts voices --provider xai - Резервные голоса для автономного режима:
ara,eve,leo,rex,sal - Голос по умолчанию:
eve - Идентификаторы пользовательских голосов учётной записи передаются, даже если они отсутствуют в ответе встроенного каталога
- Форматы:
mp3,wav,pcm,mulaw,alaw - Язык: код BCP-47 или
auto - Скорость: собственное переопределение скорости поставщика
- Собственный формат голосовых сообщений Opus не поддерживается
OpenClaw использует пакетную конечную точку xAI
/v1/tts для буферизованного синтеза,
аутентифицированное обнаружение каталога /v1/tts/voices и собственный
wss://api.x.ai/v1/tts для потокового синтеза. Потоковая передача ограничена
собственным узлом api.x.ai, поэтому пользовательские значения baseUrl в этом
пути отклоняются. Используются существующие параметры языка, голоса, кодека и скорости; для
частоты дискретизации и битрейта применяются значения xAI по умолчанию. При синтезе аудиофайлов учитываются все
настроенные кодеки. Для целевых голосовых сообщений при потоковой передаче и буферизованном
резервном режиме используется MP3, поскольку необработанные кодеки xAI не содержат метаданных кодека и частоты. Поток
отправляет text.delta, затем
text.done, получает audio.delta, audio.done или error и применяет
тайм-аут простоя timeoutMs, который обновляется для каждого фрагмента аудио. Этот механизм не связан
с сеансами голосовой связи в реальном времени. См. контракт xAI API потокового TTS.Преобразование речи в текст
Преобразование речи в текст
Встроенный плагин Язык можно указать в общей конфигурации аудиомедиа или в отдельном
запросе транскрибирования. Общий интерфейс OpenClaw принимает подсказки,
но интеграция xAI REST STT передаёт только файл и язык,
поскольку только они соответствуют текущей общедоступной конечной точке xAI.
xai регистрирует пакетное преобразование речи в текст через
интерфейс транскрибирования для анализа медиафайлов OpenClaw.- Конечная точка: xAI REST
/v1/stt - Путь ввода: загрузка аудиофайла как составных данных
- Выбор модели: xAI выбирает модель транскрибирования автоматически; в этой конечной точке нет параметра выбора модели
- Используется везде, где при транскрибировании входящего аудио считывается
tools.media.audio, включая сегменты голосовых каналов Discord и аудиовложения каналов
Потоковое преобразование речи в текст
Потоковое преобразование речи в текст
Встроенный плагин Конфигурация поставщика находится в
xai также регистрирует поставщика транскрибирования в реальном времени
для аудио голосовых вызовов.- Конечная точка: xAI WebSocket
wss://api.x.ai/v1/stt - Кодирование по умолчанию:
mulaw - Частота дискретизации по умолчанию:
8000 - Определение конца речи по умолчанию:
800ms - Промежуточные транскрипции: включены по умолчанию
plugins.entries.voice-call.config.streaming.providers.xai. Поддерживаются
ключи apiKey, baseUrl, sampleRate, encoding (pcm, mulaw или
alaw), interimResults, endpointingMs и language.Этот поставщик потоковой передачи предназначен для пути транскрибирования голосовых вызовов в реальном времени.
Discord записывает короткие сегменты и вместо него использует путь пакетного
транскрибирования
tools.media.audio.Голосовая связь в реальном времени (Talk)
Голосовая связь в реальном времени (Talk)
Встроенный плагин Конфигурация поставщика также разрешается из
xai регистрирует сеансы Grok Voice Agent в реальном времени для
режима Talk через общий контракт registerRealtimeVoiceProvider.- Конечная точка:
wss://api.x.ai/v1/realtime?model=<voice-model> - Модель по умолчанию:
grok-voice-latest - Голос по умолчанию:
eve - Транспорт:
gateway-relay(пути ретрансляции iOS, Android и Control UI) - Аудио: PCM16 24 кГц или G.711 µ-law 8 кГц
- Перебивание: серверный VAD xAI прерывает ответ; OpenClaw очищает очередь воспроизведения и обрезает невоспроизведённую историю поставщика
plugins.entries.voice-call.config.realtime.providers.xai, когда Voice Call
или общие селекторы реального времени повторно используют ту же карту поставщиков. Поддерживаются ключи
apiKey, baseUrl, model, voice, vadThreshold, silenceDurationMs,
prefixPaddingMs, reasoningEffort и sessionResumption.
reasoningEffort принимает только high или none, согласно API xAI Voice Agent.Серверный VAD xAI всегда создаёт ответы и обрабатывает прерывание аудио.
Используйте consultRouting: "provider-direct"; принудительная маршрутизация транскрипций и отключение
прерывания входящего аудио не поддерживаются протоколом xAI Voice Agent.Для аутентификации голосовой связи в реальном времени можно использовать xAI OAuth или
XAI_API_KEY.
WebRTC под управлением браузера пока не входит в интерфейс этого поставщика; используйте Talk с ретрансляцией через Gateway
на нативных узлах или путь ретрансляции Control UI.По умолчанию
sessionResumption имеет значение false. Если задано значение true, OpenClaw просит
xAI сохранить достаточно состояния сеанса, чтобы после
повторного подключения продолжить тот же разговор, а затем подключается повторно с возвращённым идентификатором разговора. Оставьте этот параметр
отключённым, если воспроизведение или хранение данных на стороне поставщика неприемлемо; в таком случае при обрыве
соединения происходит безопасный отказ вместо незаметного запуска нового разговора.Настройка x_search
Настройка x_search
Встроенный плагин xAI предоставляет
x_search как инструмент OpenClaw для
поиска содержимого X (ранее Twitter) с помощью Grok.Путь конфигурации: plugins.entries.xai.config.xSearchНастройка выполнения кода
Настройка выполнения кода
Встроенный плагин xAI предоставляет
code_execution как инструмент OpenClaw для
удалённого выполнения кода в изолированной среде xAI.Путь конфигурации: plugins.entries.xai.config.codeExecutionЭто удалённое выполнение в изолированной среде xAI, а не локальный
exec.Известные ограничения
Известные ограничения
- Для аутентификации xAI можно использовать ключ API, переменную окружения, резервную конфигурацию плагина или OAuth с подходящей учётной записью xAI. OAuth использует проверку по коду устройства без обратного вызова через localhost. xAI определяет, какие учётные записи могут получать токены API OAuth, а на странице согласия может отображаться Grok Build, хотя OpenClaw не требует приложения Grok Build.
- В настоящее время OpenClaw не предоставляет доступ к семейству мультиагентных моделей xAI. xAI обслуживает эти модели через Responses API, но они не принимают клиентские или пользовательские инструменты, используемые общим циклом агента OpenClaw. См. ограничения мультиагентного режима xAI.
- В настоящее время голосовой режим xAI Realtime предоставляет только транспорт Talk через ретрансляцию Gateway. Сеансы WebSocket провайдера, управляемые браузером, пока не подключены в интерфейсе управления.
- Изображение xAI
quality, изображениеmaskи дополнительные соотношения сторон, доступные только в нативном режиме, не предоставляются, пока в общем инструменте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принадлежат встроенному плагину xAI, а не жёстко заданы в основном исполняющем модуле моделей.code_execution— это удалённое выполнение в песочнице xAI, а не локальныйexec.
Тестирование в реальном окружении
Медиапути xAI покрыты модульными тестами и подключаемыми наборами проверок в реальной среде. ЭкспортируйтеXAI_API_KEY в окружение процесса перед запуском проверок в реальной среде.
Связанные материалы
Выбор модели
Выбор провайдеров, ссылок на модели и поведения при аварийном переключении.
Генерация видео
Общие параметры инструмента для работы с видео и выбор провайдера.
Все провайдеры
Более широкий обзор провайдеров.
Устранение неполадок
Распространённые проблемы и способы их устранения.