Langsung ke konten utama
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.
PropertiNilai
Nama toolcode_execution
Plugin penyediaxai (bawaan, enabledByDefault: true)
Authprofil auth xAI, XAI_API_KEY, atau plugins.entries.xai.config.webSearch.apiKey
Model defaultgrok-4-1-fast
Timeout default30 detik
maxTurns defaulttidak 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

1

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.
openclaw models auth login --provider xai --method oauth
Selama instalasi baru, pilihan auth yang sama tersedia di dalam onboarding:
openclaw onboard --install-daemon
openclaw onboard --install-daemon --auth-choice xai-oauth
Atau gunakan API key:
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
Atau melalui konfigurasi:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

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

Mulai ulang Gateway

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: 
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.
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: 
{
  "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.

​
Terkait

Tool Exec

Eksekusi shell lokal di mesin Anda atau node yang dipasangkan.

Persetujuan Exec

Kebijakan izinkan/tolak untuk eksekusi shell.

Tool web

web_search, x_search, dan web_fetch.

Penyedia xAI

Model Grok, pencarian web/x, dan konfigurasi eksekusi kode.