xAI

Вбудований provider вебпошуку grok також використовує XAI_API_KEY:

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 таких зображень

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

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

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

• Модель зображення за замовчуванням: xai/grok-imagine-image
• Додаткова модель: xai/grok-imagine-image-pro
• Режими: 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 зображень

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

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

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

Вбудований Plugin xai реєструє text-to-speech через спільну поверхню provider tts.

• Голоси: eve, ara, rex, sal, leo, una
• Голос за замовчуванням: eve
• Формати: mp3, wav, pcm, mulaw, alaw
• Мова: код BCP-47 або auto
• Швидкість: provider-native перевизначення швидкості
• Нативний формат голосових нотаток Opus не підтримується

Щоб використовувати xAI як provider 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, але інтеграція xAI REST STT передає лише файл, модель і мову, оскільки вони чітко відповідають поточному публічному endpoint xAI.

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

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

Медіапотік Twilio у Voice Call надсилає аудіокадри G.711 µ-law, тому provider 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 для віддаленого виконання коду в sandbox-середовищі xAI.

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

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

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