Tools
Виконання коду
code_execution запускає ізольований віддалений аналіз Python через Responses API від xAI
(https://api.x.ai/v1/responses, та сама кінцева точка, яку використовує x_search). Його
реєструє вбудований Plugin xai за контрактом tools.
| Властивість | Значення |
|---|---|
| Назва інструмента | code_execution |
| Plugin провайдера | 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):
openclaw models auth login --provider xai --method oauthПід час нової інсталяції той самий варіант доступний у початковому налаштуванні:
openclaw onboard --install-daemon --auth-choice xai-oauthАбо ключ API:
openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...Або через конфігурацію:
{ 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 потрібні завжди.
Використовуйте той самий блок, щоб перевизначити модель, обмеження кількості ітерацій або тайм-аут:
{ plugins: { entries: { xai: { config: { codeExecution: { enabled: true, // required for a known non-xAI model provider model: "grok-4.3", // override the default xAI code-execution model maxTurns: 2, // optional cap on internal tool turns timeoutSeconds: 30, // request timeout (default: 30) }, }, }, }, },}Перезапустіть Gateway
openclaw gateway restartcode_execution з'явиться у списку інструментів агента, щойно Plugin xAI
повторно зареєструється та пройдуть наведені вище перевірки провайдера,
увімкнення й автентифікації.
Використання
Чітко вкажіть мету аналізу; інструмент приймає єдиний параметр task,
тому надсилайте повний запит і всі вбудовані дані в одному запиті:
Використай code_execution, щоб обчислити 7-денне ковзне середнє для цих чисел: ...Використай x_search, щоб знайти дописи зі згадкою OpenClaw за цей тиждень, а потім використай code_execution, щоб підрахувати їх за днями.Використай web_search, щоб зібрати найновіші результати тестів продуктивності ШІ, а потім використай code_execution, щоб порівняти відсоткові зміни.Помилки
Без автентифікації інструмент повертає структуровану помилку JSON (а не викинутий виняток), тож агент може самостійно виправити проблему:
{ "error": "missing_xai_api_key", "message": "code_execution needs xAI credentials. Run `openclaw onboard --auth-choice xai-oauth` to sign in with Grok, 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"}