---
read_when:
- Вы хотите включить или настроить code_execution
- Вам нужен удалённый анализ без доступа к локальной командной оболочке
- Вы хотите объединить x_search или web_search с удалённым анализом на Python
summary: 'code_execution: запуск изолированного удалённого анализа на Python с помощью xAI'
title: Выполнение кода
x-i18n:
generated_at: "2026-07-13T18:42:08Z"
model: gpt-5.6
postprocess_version: locale-links-v1
prompt_version: 24
provider: openai
source_hash: 1ab391daed9154f113535e6d241c45d5c08c22abdc012148a9f0f2ae5ec548b3
source_path: tools/code-execution.md
workflow: 16
---
`code_execution` выполняет изолированный удалённый анализ на Python через Responses API от xAI
(`https://api.x.ai/v1/responses`, тот же эндпоинт, который использует `x_search`). Он
регистрируется встроенным плагином `xai` в рамках контракта `tools`.
`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`](/ru/tools/web#x_search)
и передайте результат в него.
Для локального выполнения используйте [`exec`](/ru/tools/exec).
## Настройка
Для OAuth требуется подходящая подписка SuperGrok или X Premium
(проверка с помощью кода устройства, поэтому этот способ работает на удалённых хостах без
обратного вызова localhost):
```bash
openclaw models auth login --provider xai --method oauth
```
При новой установке тот же вариант доступен во время первоначальной настройки:
```bash
openclaw onboard --install-daemon --auth-choice xai-oauth
```
Или используйте ключ API:
```bash
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
```
Либо задайте его в конфигурации:
```json5
{
plugins: {
entries: {
xai: {
config: {
webSearch: {
apiKey: "xai-...",
},
},
},
},
},
}
```
Любой из этих трёх вариантов также обеспечивает работу `x_search` и Grok `web_search`.
Если `enabled` не задан, `code_execution` доступен только тогда, когда провайдером
активной модели является `xai` и учётные данные xAI успешно определены. Для активной модели
с известным провайдером, отличным от xAI, задайте
`plugins.entries.xai.config.codeExecution.enabled` равным `true`, чтобы явно разрешить
использование между провайдерами. Если провайдер активной модели отсутствует или не определён,
инструмент остаётся скрытым. Задайте `enabled` равным `false`, чтобы отключить его для всех
провайдеров. Учётные данные xAI требуются всегда.
В том же блоке можно переопределить модель, ограничение количества итераций или тайм-аут:
```json5
{
plugins: {
entries: {
xai: {
config: {
codeExecution: {
enabled: true, // обязательно для известного провайдера модели, отличного от xAI
model: "grok-4.3", // переопределяет модель xAI для выполнения кода по умолчанию
maxTurns: 2, // необязательное ограничение числа внутренних итераций инструмента
timeoutSeconds: 30, // тайм-аут запроса (по умолчанию: 30)
},
},
},
},
},
}
```
```bash
openclaw gateway restart
```
`code_execution` появится в списке инструментов агента после того, как плагин xAI
повторно зарегистрируется и успешно пройдут указанные выше проверки провайдера, включения и аутентификации.
## Использование
Явно укажите цель анализа; инструмент принимает один параметр `task`,
поэтому передавайте полный запрос и все встроенные данные в одном промпте:
```text
Используй code_execution, чтобы вычислить 7-дневное скользящее среднее для этих чисел: ...
```
```text
Используй x_search, чтобы найти публикации с упоминанием OpenClaw за эту неделю, а затем используй code_execution, чтобы подсчитать их по дням.
```
```text
Используй web_search, чтобы собрать последние результаты тестов производительности ИИ, а затем используй code_execution, чтобы сравнить процентные изменения.
```
## Ошибки
При отсутствии аутентификации инструмент возвращает структурированную ошибку JSON (а не выбрасывает
исключение), поэтому агент может самостоятельно исправить проблему:
```json
{
"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"
}
```
## Связанные материалы
Локальное выполнение команд оболочки на вашем компьютере или сопряжённом узле.
Политика разрешения и запрета выполнения команд оболочки.
`web_search`, `x_search` и `web_fetch`.
Модели Grok, поиск в интернете и X, а также конфигурация выполнения кода.