Tools

Eksekusi kode

code_execution menjalankan analisis Python jarak jauh yang di-sandbox pada Responses API xAI. Ini didaftarkan oleh Plugin xai bawaan (di bawah kontrak tools) dan meneruskan ke endpoint https://api.x.ai/v1/responses yang sama dengan yang digunakan oleh x_search.

Properti	Nilai
Nama tool	`code_execution`
Plugin penyedia	`xai` (bawaan, `enabledByDefault: true`)
Auth	profil auth xAI, `XAI_API_KEY`, atau `plugins.entries.xai.config.webSearch.apiKey`
Model default	`grok-4-1-fast`
Timeout default	30 detik
`maxTurns` default	tidak disetel (xAI menerapkan batas internalnya sendiri)

Ini berbeda dari exec lokal:

exec menjalankan perintah shell di mesin Anda atau node yang dipasangkan.
code_execution menjalankan Python di sandbox jarak jauh xAI.

Gunakan code_execution untuk:

Perhitungan.
Tabulasi.
Statistik cepat.
Analisis bergaya bagan.
Menganalisis data yang dikembalikan oleh x_search atau web_search.

Jangan gunakan ini saat Anda memerlukan file lokal, shell Anda, repo Anda, atau perangkat yang dipasangkan. Gunakan exec untuk itu.

Penyiapan

Berikan kredensial xAI

Masuk dengan Grok OAuth menggunakan langganan SuperGrok atau X Premium yang memenuhi syarat, atau simpan API key. xAI OAuth menggunakan verifikasi kode perangkat, sehingga berfungsi dari host jarak jauh tanpa callback localhost. OAuth berfungsi untuk code_execution dan x_search; XAI_API_KEY atau konfigurasi web-search Plugin juga dapat menjalankan Grok web_search.

bash

openclaw models auth login --provider xai --method oauth

Selama instalasi baru, pilihan auth yang sama tersedia di dalam onboarding:

bash

openclaw onboard --install-daemonopenclaw onboard --install-daemon --auth-choice xai-oauth

Atau gunakan API key:

bash

openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...

Atau melalui konfigurasi:

json5

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

Aktifkan dan sesuaikan code_execution

code_execution tersedia saat kredensial xAI tersedia. Setel plugins.entries.xai.config.codeExecution.enabled ke false untuk menonaktifkannya, atau gunakan blok yang sama untuk menyesuaikan model dan timeout.

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

Mulai ulang Gateway

bash

openclaw gateway restart

code_execution muncul di daftar tool agen setelah Plugin xAI mendaftar ulang dengan enabled: true.

Cara menggunakannya

Ajukan permintaan secara alami dan buat maksud analisisnya eksplisit:

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.

Tool ini menerima satu parameter task secara internal, sehingga agen harus mengirim permintaan analisis lengkap dan data inline apa pun dalam satu prompt.

Error

Saat tool berjalan tanpa auth, tool mengembalikan error missing_xai_api_key terstruktur yang menunjuk ke opsi profil auth, env var, dan konfigurasi. Error tersebut berupa JSON, bukan exception yang dilempar, sehingga agen dapat memperbaiki sendiri:

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

Batasan

Ini adalah eksekusi jarak jauh xAI, bukan eksekusi proses lokal.
Perlakukan hasil sebagai analisis sementara, bukan sesi notebook persisten.
Jangan berasumsi ada akses ke file lokal atau workspace Anda.
Untuk data X terbaru, gunakan x_search terlebih dahulu dan teruskan hasilnya ke code_execution.