Tools

Wykonywanie kodu

code_execution uruchamia izolowaną zdalną analizę w Pythonie w Responses API xAI. Jest rejestrowane przez dołączony Plugin xai (w ramach kontraktu tools) i wysyła żądania do tego samego punktu końcowego https://api.x.ai/v1/responses, którego używa x_search.

Właściwość	Wartość
Nazwa narzędzia	`code_execution`
Plugin dostawcy	`xai` (dołączony, `enabledByDefault: true`)
Uwierzytelnianie	profil uwierzytelniania xAI, `XAI_API_KEY` lub `plugins.entries.xai.config.webSearch.apiKey`
Model domyślny	`grok-4-1-fast`
Domyślny limit czasu	30 sekund
Domyślny `maxTurns`	nieustawione (xAI stosuje własny limit wewnętrzny)

Różni się to od lokalnego exec:

exec uruchamia polecenia powłoki na Twoim komputerze lub sparowanym węźle.
code_execution uruchamia Python w zdalnym sandboxie xAI.

Używaj code_execution do:

Obliczeń.
Tworzenia tabel.
Szybkich statystyk.
Analiz w stylu wykresów.
Analizowania danych zwróconych przez x_search lub web_search.

Nie używaj go, gdy potrzebujesz lokalnych plików, swojej powłoki, repozytorium lub sparowanych urządzeń. Do tego użyj exec.

Konfiguracja

Provide an xAI API key

Uruchom openclaw onboard --auth-choice xai-api-key dla code_execution i x_search, albo ustaw XAI_API_KEY / skonfiguruj klucz w Pluginie xAI, gdy chcesz także, aby wyszukiwanie internetowe Grok używało tych samych danych uwierzytelniających:

bash

export XAI_API_KEY=xai-...

Albo przez konfigurację:

json5

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

Enable and tune code_execution

Narzędzie jest sterowane przez plugins.entries.xai.config.codeExecution.enabled. Domyślnie jest wyłączone.

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)          },        },      },    },  },}

Restart the Gateway

bash

openclaw gateway restart

code_execution pojawia się na liście narzędzi agenta, gdy Plugin xAI ponownie zarejestruje się z enabled: true.

Jak go używać

Pytaj naturalnie i jasno określ intencję analizy:

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.

Narzędzie wewnętrznie przyjmuje pojedynczy parametr task, więc agent powinien wysłać pełne żądanie analizy i wszelkie dane w treści w jednym prompcie.

Błędy

Gdy narzędzie działa bez uwierzytelniania, zwraca ustrukturyzowany błąd missing_xai_api_key, wskazujący profil uwierzytelniania, zmienną środowiskową i opcje konfiguracji. Błąd ma postać JSON, a nie rzuconego wyjątku, więc agent może samodzielnie go skorygować:

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

Limity

To jest zdalne wykonywanie xAI, a nie wykonywanie lokalnego procesu.
Traktuj wyniki jako tymczasową analizę, a nie trwałą sesję notebooka.
Nie zakładaj dostępu do lokalnych plików ani swojego obszaru roboczego.
Aby uzyskać świeże dane z X, najpierw użyj x_search, a następnie przekaż wynik do code_execution.

Powiązane

Exec tool

Lokalne wykonywanie poleceń powłoki na Twoim komputerze lub sparowanym węźle.

Exec approvals

Zasady zezwalania/odmawiania dla wykonywania poleceń powłoki.

Web tools

web_search, x_search i web_fetch.

xAI provider

Modele Grok, wyszukiwanie web/x oraz konfiguracja wykonywania kodu.

Was this useful?