Перейти до основного вмісту
code_execution запускає ізольований віддалений аналіз Python в API Responses від xAI. Його реєструє вбудований Plugin xai (у межах контракту tools), і він надсилає запити до тієї самої кінцевої точки https://api.x.ai/v1/responses, яку використовує x_search.
ВластивістьЗначення
Назва інструментаcode_execution
Plugin провайдераxai (вбудований, enabledByDefault: true)
Автентифікаціяпрофіль автентифікації xAI, XAI_API_KEY або plugins.entries.xai.config.webSearch.apiKey
Типова модельgrok-4-1-fast
Типовий тайм-аут30 секунд
Типовий maxTurnsне задано (xAI застосовує власний внутрішній ліміт)
Це відрізняється від локального exec:
  • exec запускає команди оболонки на вашій машині або спареному вузлі.
  • code_execution запускає Python у віддаленій ізольованій пісочниці xAI.
Використовуйте code_execution для:
  • Обчислень.
  • Табуляції.
  • Швидкої статистики.
  • Аналізу у стилі діаграм.
  • Аналізу даних, повернутих x_search або web_search.
Не використовуйте його, коли вам потрібні локальні файли, ваша оболонка, ваш репозиторій або спарені пристрої. Для цього використовуйте exec.

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

1

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

Увійдіть через Grok OAuth за допомогою відповідної підписки SuperGrok або X Premium або збережіть API-ключ. xAI OAuth використовує перевірку через код пристрою, тому працює з віддалених хостів без localhost callback. OAuth працює для code_execution і x_search; XAI_API_KEY або конфігурація вебпошуку Plugin також можуть забезпечувати роботу Grok web_search.
openclaw models auth login --provider xai --method oauth
Під час свіжого встановлення ті самі варіанти автентифікації доступні в onboarding:
openclaw onboard --install-daemon
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-...",
          },
        },
      },
    },
  },
}
2

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

code_execution доступний, коли наявні облікові дані xAI. Установіть plugins.entries.xai.config.codeExecution.enabled на false, щоб вимкнути його, або використайте той самий блок, щоб налаштувати модель і тайм-аут.
{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast", // override the default xAI code-execution model
            maxTurns: 2,            // optional cap on internal tool turns
            timeoutSeconds: 30,     // request timeout (default: 30)
          },
        },
      },
    },
  },
}
3

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

openclaw gateway restart
code_execution з’явиться у списку інструментів агента, щойно Plugin xAI повторно зареєструється з enabled: true.

​
Як ним користуватися

Запитуйте природно й явно вказуйте намір аналізу: 
Use code_execution to calculate the 7-day moving average for these numbers: ...

Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.

Use web_search to gather the latest AI benchmark numbers, then use code_execution to compare percent changes.
Інструмент внутрішньо приймає один параметр task, тому агент має надіслати повний запит на аналіз і будь-які вбудовані дані в одному prompt.

​
Помилки

Коли інструмент запускається без автентифікації, він повертає структуровану помилку missing_xai_api_key, яка вказує на профіль автентифікації, змінну середовища та параметри конфігурації. Помилка має формат 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"
}

​
Обмеження

  • Це віддалене виконання xAI, а не виконання локального процесу.
  • Сприймайте результати як ефемерний аналіз, а не як постійну сесію notebook.
  • Не припускайте доступу до локальних файлів або вашого робочого простору.
  • Для свіжих даних X спочатку використайте x_search і передайте результат у code_execution.

​
Пов’язане

Інструмент Exec

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

Схвалення Exec

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

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

web_search, x_search і web_fetch.

Провайдер xAI

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