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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Надайте API-ключ xAI

Запустіть openclaw onboard --auth-choice xai-api-key для code_execution і x_search, або задайте XAI_API_KEY / налаштуйте ключ у Plugin xAI, якщо ви також хочете, щоб вебпошук Grok використовував ті самі облікові дані:
export XAI_API_KEY=xai-...
Або через конфігурацію:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

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

Інструмент керується параметром plugins.entries.xai.config.codeExecution.enabled. За замовчуванням вимкнено.
{
  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 an xAI API key. 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 і конфігурація виконання коду.