---
read_when:
    - Ви хочете ввімкнути або налаштувати code_execution
    - Вам потрібен віддалений аналіз без доступу до локальної оболонки
    - Ви хочете поєднати x_search або web_search із віддаленим аналізом у Python
summary: 'code_execution: виконувати ізольований віддалений аналіз Python за допомогою xAI'
title: Виконання коду
x-i18n:
    generated_at: "2026-05-11T21:00:00Z"
    model: gpt-5.5
    provider: openai
    source_hash: 76be496e459fac9c7f6b0324cceb884d3a693fd72d7541094d1bb64a4f1b7b8b
    source_path: tools/code-execution.md
    workflow: 16
---

`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`](/uk/tools/exec):

- `exec` запускає команди оболонки на вашій машині або спареному вузлі.
- `code_execution` запускає Python у віддаленій пісочниці xAI.

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

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

**Не** використовуйте його, коли вам потрібні локальні файли, ваша оболонка, ваш репозиторій або спарені пристрої. Для цього використовуйте [`exec`](/uk/tools/exec).

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

<Steps>
  <Step title="Надайте API-ключ xAI">
    Запустіть `openclaw onboard --auth-choice xai-api-key` для `code_execution` і
    `x_search`, або задайте `XAI_API_KEY` / налаштуйте ключ у Plugin xAI,
    якщо ви також хочете, щоб вебпошук Grok використовував ті самі облікові дані:

    ```bash
    export XAI_API_KEY=xai-...
    ```

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

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

  </Step>

  <Step title="Увімкніть і налаштуйте code_execution">
    Інструмент керується параметром `plugins.entries.xai.config.codeExecution.enabled`. За замовчуванням вимкнено.

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

  </Step>

  <Step title="Перезапустіть Gateway">
    ```bash
    openclaw gateway restart
    ```

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

  </Step>
</Steps>

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

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

```text
Use code_execution to calculate the 7-day moving average for these numbers: ...
```

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

```text
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, а не викидається як виняток, тому агент може самостійно виправитися:

```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`](/uk/tools/web#x_search), а потім передайте результат у `code_execution`.

## Пов’язане

<CardGroup cols={2}>
  <Card title="Інструмент Exec" href="/uk/tools/exec" icon="terminal">
    Локальне виконання команд оболонки на вашій машині або спареному вузлі.
  </Card>
  <Card title="Схвалення Exec" href="/uk/tools/exec-approvals" icon="shield">
    Політика дозволу/заборони для виконання команд оболонки.
  </Card>
  <Card title="Вебінструменти" href="/uk/tools/web" icon="globe">
    `web_search`, `x_search` і `web_fetch`.
  </Card>
  <Card title="Постачальник xAI" href="/uk/providers/xai" icon="microchip">
    Моделі Grok, вебпошук/пошук X і конфігурація виконання коду.
  </Card>
</CardGroup>