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
• Режимы: 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
• Входные reference-данные: одно 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
• Endpoint: 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 передает только файл, модель и язык, потому что они напрямую соответствуют текущему публичному endpoint xAI.

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

• Endpoint: xAI WebSocket wss://api.x.ai/v1/stt
• Кодировка по умолчанию: mulaw
• Частота дискретизации по умолчанию: 8000
• Endpointing по умолчанию: 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",          },        },      },    },  },}

• Аутентификация xAI может использовать API-ключ, переменную окружения, резервную конфигурацию Plugin или OAuth с подходящей учетной записью xAI. OAuth использует проверку device-code без callback на localhost. xAI решает, какие учетные записи могут получать OAuth API-токены, а страница согласия может показывать 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 — это удаленное выполнение в песочнице xAI, а не локальный exec.