> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Выполнение кода

`code_execution` выполняет изолированный удалённый анализ на Python через Responses API от xAI
(`https://api.x.ai/v1/responses`, тот же эндпоинт, который использует `x_search`). Он
регистрируется встроенным плагином `xai` в рамках контракта `tools`.

> [!WARNING]
>
> `code_execution` выполняется на серверах xAI. xAI взимает \$5 за 1,000 вызовов инструмента
> плюс стоимость входных и выходных токенов модели.

| Свойство | Значение |
| - | - |
| Название инструмента | `code_execution` |
| Плагин провайдера | `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`](https://docs2.openclaw.ai/ru/tools/web#x_search)
и передайте результат в него.

Для локального выполнения используйте [`exec`](https://docs2.openclaw.ai/ru/tools/exec).

## Настройка

**1. Предоставьте учётные данные xAI**

Для OAuth требуется подходящая подписка SuperGrok или X Premium
(проверка с помощью кода устройства, поэтому этот способ работает на удалённых хостах без
обратного вызова localhost):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth login --provider xai --method oauth
```

При новой установке тот же вариант доступен во время первоначальной настройки:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon --auth-choice xai-oauth
```

Или используйте ключ API:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
```

Либо задайте его в конфигурации:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
```

Любой из этих трёх вариантов также обеспечивает работу `x_search` и Grok `web_search`.

**2. Включите и настройте code\_execution**

Если `enabled` не задан, `code_execution` доступен только тогда, когда провайдером
активной модели является `xai` и учётные данные xAI успешно определены. Для активной модели
с известным провайдером, отличным от xAI, задайте
`plugins.entries.xai.config.codeExecution.enabled` равным `true`, чтобы явно разрешить
использование между провайдерами. Если провайдер активной модели отсутствует или не определён,
инструмент остаётся скрытым. Задайте `enabled` равным `false`, чтобы отключить его для всех
провайдеров. Учётные данные xAI требуются всегда.

В том же блоке можно переопределить модель, ограничение количества итераций или тайм-аут:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true, // обязательно для известного провайдера модели, отличного от xAI
            model: "grok-4.3", // переопределяет модель xAI для выполнения кода по умолчанию
            maxTurns: 2,            // необязательное ограничение числа внутренних итераций инструмента
            timeoutSeconds: 30,     // тайм-аут запроса (по умолчанию: 30)
          },
        },
      },
    },
  },
}
```

**3. Перезапустите Gateway**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway restart
```

`code_execution` появится в списке инструментов агента после того, как плагин xAI
повторно зарегистрируется и успешно пройдут указанные выше проверки провайдера, включения и аутентификации.

## Использование

Явно укажите цель анализа; инструмент принимает один параметр `task`,
поэтому передавайте полный запрос и все встроенные данные в одном промпте:

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
Используй code_execution, чтобы вычислить 7-дневное скользящее среднее для этих чисел: ...
```

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
Используй x_search, чтобы найти публикации с упоминанием OpenClaw за эту неделю, а затем используй code_execution, чтобы подсчитать их по дням.
```

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
Используй web_search, чтобы собрать последние результаты тестов производительности ИИ, а затем используй code_execution, чтобы сравнить процентные изменения.
```

## Ошибки

При отсутствии аутентификации инструмент возвращает структурированную ошибку JSON (а не выбрасывает
исключение), поэтому агент может самостоятельно исправить проблему:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "error": "missing_xai_api_key",
  "message": "Для code_execution требуются учётные данные xAI. Выполните `openclaw onboard --auth-choice xai-oauth`, чтобы войти через Grok, выполните `openclaw onboard --auth-choice xai-api-key`, задайте `XAI_API_KEY` в окружении Gateway или настройте `plugins.entries.xai.config.webSearch.apiKey`.",
  "docs": "https://docs.openclaw.ai/tools/code-execution"
}
```

## Связанные материалы

> [card] [Инструмент Exec](https://docs2.openclaw.ai/ru/tools/exec.md)
>
> Локальное выполнение команд оболочки на вашем компьютере или сопряжённом узле.

> [card] [Подтверждения Exec](https://docs2.openclaw.ai/ru/tools/exec-approvals.md)
>
> Политика разрешения и запрета выполнения команд оболочки.

> [card] [Веб-инструменты](https://docs2.openclaw.ai/ru/tools/web.md)
>
> `web_search`, `x_search` и `web_fetch`.

> [card] [Провайдер xAI](https://docs2.openclaw.ai/ru/providers/xai.md)
>
> Модели Grok, поиск в интернете и X, а также конфигурация выполнения кода.