Eksekusi kode

code_execution menjalankan analisis Python jarak jauh dalam sandbox pada Responses API milik xAI. Alat ini didaftarkan oleh Plugin xai yang dibundel (di bawah kontrak tools) dan mengirim 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 dalam 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 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

Minta secara alami dan jelaskan niat analisis secara 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 menggunakan 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 auth, alat ini mengembalikan kesalahan terstruktur missing_xai_api_key yang menunjuk ke variabel env dan path config. Kesalahan tersebut berupa JSON, bukan exception yang dilempar, sehingga agen dapat memperbaiki sendiri:

{
  "error": "missing_xai_api_key",
  "message": "code_execution needs an 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 asumsikan akses ke file lokal atau workspace Anda.
• Untuk data X terbaru, gunakan x_search terlebih dahulu dan salurkan hasilnya ke code_execution.

# Terkait