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

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

Це відрізняється від локального exec:

• exec запускає команди shell на вашому комп’ютері або спареному вузлі.
• code_execution запускає Python у віддаленій ізольованій пісочниці xAI.

Використовуйте code_execution для:

• Обчислень.
• Табулювання.
• Швидкої статистики.
• Аналізу у стилі діаграм.
• Аналізу даних, повернутих x_search або web_search.

Не використовуйте його, коли потрібні локальні файли, ваш shell, ваш репозиторій або спарені пристрої. Для цього використовуйте exec.

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

export XAI_API_KEY=xai-...

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

{
  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)
          },
        },
      },
    },
  },
}

openclaw gateway restart

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

Запитуйте природною мовою й явно вказуйте намір аналізу:

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 an 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.

# Пов’язане