Eksekusi kode

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

Ini berbeda dari exec lokal:

• exec menjalankan perintah shell di mesin Anda atau node yang dipasangkan.
• code_execution menjalankan Python di sandbox jarak jauh milik 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

export XAI_API_KEY=xai-...

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

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

openclaw gateway restart

Cara menggunakannya

Ajukan permintaan secara alami dan buat maksud analisisnya eksplisit:

Use code_execution to calculate the 7-day moving average for these numbers: ...

Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.

Use web_search to gather the latest AI benchmark numbers, then use code_execution to compare percent changes.

Alat ini mengambil satu parameter task secara internal, jadi agen harus mengirim permintaan analisis lengkap dan data inline apa pun dalam satu prompt.

Kesalahan

Saat alat berjalan tanpa autentikasi, alat ini mengembalikan kesalahan missing_xai_api_key terstruktur yang menunjuk ke opsi profil autentikasi, env var, dan config. Kesalahan ini berupa JSON, bukan exception yang dilempar, sehingga agen dapat memperbaiki sendiri:

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

Batasan

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

Terkait