OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

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

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

Свойство Значение
Название инструмента 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 и передайте результат в него.

Для локального выполнения используйте exec.

Настройка

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

    Для 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-keyexport XAI_API_KEY=xai-...

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

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

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

  • Включите и настройте code_execution

    Если 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)          },        },      },    },  },}

  • Перезапустите Gateway

    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"}

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

    Инструмент Exec

    Локальное выполнение команд оболочки на вашем компьютере или сопряжённом узле.
    Подтверждения Exec

    Политика разрешения и запрета выполнения команд оболочки.
    Веб-инструменты

    web_search, x_search и web_fetch.
    Провайдер xAI

    Модели Grok, поиск в интернете и X, а также конфигурация выполнения кода.
    Was this useful?
    On this page

    On this page