Виконання коду

code_execution запускає ізольований віддалений аналіз Python через Responses API від xAI (https://api.x.ai/v1/responses, та сама кінцева точка, яку використовує x_search). Його реєструє вбудований Plugin xai за контрактом tools.

code_execution виконується на серверах xAI. xAI стягує $5 за 1 000 викликів інструмента, а також плату за вхідні й вихідні токени моделі.

Властивість	Значення
Назва інструмента	`code_execution`
Plugin провайдера	`xai` (вбудований, `enabledByDefault: true`)
Автентифікація	профіль автентифікації xAI, `XAI_API_KEY` або `plugins.entries.xai.config.webSearch.apiKey`
Модель за замовчуванням	`grok-4.3`
Тайм-аут за замовчуванням	30 секунд
`maxTurns` за замовчуванням	не задано (xAI застосовує власне внутрішнє обмеження)

Використовуйте його для обчислень, табулювання, швидкої статистики й аналізу у вигляді діаграм, зокрема даних, повернутих x_search або web_search. Він не має доступу до локальних файлів, вашої оболонки, репозиторію чи спарених пристроїв і не зберігає стан між викликами, тому вважайте кожен виклик тимчасовим аналізом, а не сеансом блокнота. Щоб отримати свіжі дані X, спочатку запустіть x_search і передайте його результат далі. Для локального виконання натомість використовуйте exec.

Налаштування

Надайте облікові дані xAI

Для OAuth потрібна відповідна передплата SuperGrok або X Premium (перевірка за кодом пристрою, тому це працює з віддалених хостів без зворотного виклику localhost):

openclaw models auth login --provider xai --method oauth

Під час нової інсталяції той самий варіант доступний у початковому налаштуванні:

openclaw onboard --install-daemon --auth-choice xai-oauth

Або ключ API:

openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...

Або через конфігурацію:

{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}

Кожен із цих трьох варіантів також забезпечує роботу x_search і Grok web_search.

Увімкніть і налаштуйте code_execution

Якщо enabled не вказано, code_execution доступний лише тоді, коли провайдером активної моделі є xai і облікові дані xAI успішно визначено. Для активної моделі з відомим провайдером, відмінним від xAI, установіть plugins.entries.xai.config.codeExecution.enabled у true, щоб явно дозволити використання між провайдерами. Якщо провайдер активної моделі не вказано або не вдалося визначити, інструмент залишається прихованим. Установіть enabled у false, щоб вимкнути його для всіх провайдерів. Облікові дані xAI потрібні завжди.Використовуйте той самий блок, щоб перевизначити модель, обмеження кількості ітерацій або тайм-аут:

{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true, // required for a known non-xAI model provider
            model: "grok-4.3", // override the default xAI code-execution model
            maxTurns: 2,            // optional cap on internal tool turns
            timeoutSeconds: 30,     // request timeout (default: 30)
          },
        },
      },
    },
  },
}

Перезапустіть Gateway

openclaw gateway restart

code_execution з’явиться у списку інструментів агента, щойно Plugin xAI повторно зареєструється та пройдуть наведені вище перевірки провайдера, увімкнення й автентифікації.

Використання

Чітко вкажіть мету аналізу; інструмент приймає єдиний параметр task, тому надсилайте повний запит і всі вбудовані дані в одному запиті:

Використай code_execution, щоб обчислити 7-денне ковзне середнє для цих чисел: ...

Використай x_search, щоб знайти дописи зі згадкою OpenClaw за цей тиждень, а потім використай code_execution, щоб підрахувати їх за днями.

Використай web_search, щоб зібрати найновіші результати тестів продуктивності ШІ, а потім використай code_execution, щоб порівняти відсоткові зміни.

Помилки

Без автентифікації інструмент повертає структуровану помилку JSON (а не викинутий виняток), тож агент може самостійно виправити проблему:

{
  "error": "missing_xai_api_key",
  "message": "code_execution needs xAI credentials. Run `openclaw onboard --auth-choice xai-oauth` to sign in with Grok, run `openclaw onboard --auth-choice xai-api-key`, set `XAI_API_KEY` in the Gateway environment, or configure `plugins.entries.xai.config.webSearch.apiKey`.",
  "docs": "https://docs.openclaw.ai/tools/code-execution"
}

Пов’язані матеріали

Інструмент Exec

Локальне виконання команд оболонки на вашому комп’ютері або спареному вузлі.

Схвалення Exec

Політика дозволу та заборони виконання команд оболонки.

Вебінструменти

web_search, x_search і web_fetch.

Провайдер xAI

Моделі Grok, вебпошук і пошук у X, а також конфігурація виконання коду.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Виконання коду

Налаштування

Використання

Помилки

Пов’язані матеріали

Інструмент Exec

Схвалення Exec

Вебінструменти

Провайдер xAI

​Налаштування

​Використання

​Помилки

​Пов’язані матеріали

Інструмент Exec

Схвалення Exec

Вебінструменти

Провайдер xAI

Налаштування

Використання

Помилки

Пов’язані матеріали