Перейти до основного вмісту

​
xAI

OpenClaw постачається з вбудованим плагіном провайдера xai для моделей Grok.

​
Початок роботи

1

Створіть API-ключ

Створіть API-ключ у консолі xAI.
2

Установіть свій API-ключ

Установіть XAI_API_KEY або виконайте:
openclaw onboard --auth-choice xai-api-key
3

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

{
  agents: { defaults: { model: { primary: "xai/grok-4" } } },
}
OpenClaw використовує xAI Responses API як вбудований транспорт xAI. Той самий XAI_API_KEY також може забезпечувати роботу Grok-backed web_search, повноцінного x_search і віддаленого code_execution. Якщо ви зберігаєте ключ xAI у plugins.entries.xai.config.webSearch.apiKey, вбудований провайдер моделей xAI також повторно використовує цей ключ як резервний варіант. Налаштування code_execution розміщені в plugins.entries.xai.config.codeExecution.

​
Каталог вбудованих моделей

OpenClaw містить такі сімейства моделей xAI з коробки:
СімействоІдентифікатори моделей
Grok 3grok-3, grok-3-fast, grok-3-mini, grok-3-mini-fast
Grok 4grok-4, grok-4-0709
Grok 4 Fastgrok-4-fast, grok-4-fast-non-reasoning
Grok 4.1 Fastgrok-4-1-fast, grok-4-1-fast-non-reasoning
Grok 4.20 Betagrok-4.20-beta-latest-reasoning, grok-4.20-beta-latest-non-reasoning
Grok Codegrok-code-fast-1
Плагін також напряму зіставляє новіші ідентифікатори grok-4* і grok-code-fast*, коли вони відповідають тій самій формі API.
grok-4-fast, grok-4-1-fast і варіанти grok-4.20-beta-* — це поточні посилання Grok із підтримкою зображень у вбудованому каталозі.

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

/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

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

Застарілі псевдоніми все ще нормалізуються до канонічних вбудованих ідентифікаторів:
Застарілий псевдонімКанонічний ідентифікатор
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_API_KEY:
openclaw config set tools.web.search.provider grok
Вбудований плагін xai реєструє генерацію відео через спільний інструмент video_generate.
  • Модель відео за замовчуванням: xai/grok-imagine-video
  • Режими: text-to-video, image-to-video, а також віддалені потоки редагування/розширення відео
  • Підтримує aspectRatio і resolution
Локальні відеобуфери не приймаються. Для вхідних даних video-reference і edit використовуйте віддалені URL-адреси http(s).
Щоб використовувати xAI як провайдера відео за замовчуванням:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "xai/grok-imagine-video",
      },
    },
  },
}
Див. Генерація відео, щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку резервного перемикання.
Вбудований плагін 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",
          },
        },
      },
    },
  },
}
  • Наразі автентифікація підтримується лише через API-ключ. В OpenClaw поки що немає потоку xAI OAuth або device-code.
  • grok-4.20-multi-agent-experimental-beta-0304 не підтримується в звичайному шляху провайдера xAI, оскільки він потребує іншої поверхні upstream API, ніж стандартний транспорт xAI в OpenClaw.
  • OpenClaw автоматично застосовує виправлення сумісності схем інструментів і викликів інструментів, специфічні для xAI, у спільному шляху виконання.
  • Нативні запити 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, який потрібен у кожному запиті інструмента, замість того щоб додавати всі нативні інструменти до кожного ходу чату.
  • x_search і code_execution належать вбудованому плагіну xAI, а не жорстко закодовані в базове середовище виконання моделі.
  • code_execution — це віддалене виконання в sandbox xAI, а не локальний exec.

​
Пов’язане

Вибір моделі

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

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

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

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

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

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

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