Kod yürütme

code_execution, xAI'ın Responses API'sinde korumalı alana alınmış uzak Python analizi çalıştırır. Paketle birlikte gelen xai Plugin'i tarafından (tools sözleşmesi kapsamında) kaydedilir ve x_search tarafından kullanılan aynı https://api.x.ai/v1/responses uç noktasına gönderilir.

Bu, yerel exec aracından farklıdır:

• exec, makinenizde veya eşleştirilmiş node üzerinde shell komutları çalıştırır.
• code_execution, Python'ı xAI'ın uzak korumalı alanında çalıştırır.

code_execution şunlar için kullanılır:

• Hesaplamalar.
• Tablo oluşturma.
• Hızlı istatistikler.
• Grafik tarzı analiz.
• x_search veya web_search tarafından döndürülen verileri analiz etme.

Yerel dosyalara, shell'inize, reponuza veya eşleştirilmiş cihazlara ihtiyacınız olduğunda bunu kullanmayın. Bunun için exec kullanın.

Kurulum

export XAI_API_KEY=xai-...

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

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4-1-fast", // varsayılan xAI kod yürütme modelini geçersiz kılar            maxTurns: 2,            // dahili araç turları için isteğe bağlı üst sınır            timeoutSeconds: 30,     // istek zaman aşımı (varsayılan: 30)          },        },      },    },  },}

openclaw gateway restart

Nasıl kullanılır

Doğal şekilde sorun ve analiz amacını açık belirtin:

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.

Araç dahili olarak tek bir task parametresi alır, bu nedenle ajan tam analiz isteğini ve varsa satır içi verileri tek bir prompt içinde göndermelidir.

Hatalar

Araç kimlik doğrulama olmadan çalıştığında, auth profili, env var ve config seçeneklerini işaret eden yapılandırılmış bir missing_xai_api_key hatası döndürür. Hata, fırlatılan bir exception değil JSON'dır; bu nedenle ajan kendi kendini düzeltebilir:

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

Sınırlar

• Bu, yerel süreç yürütmesi değil, uzak xAI yürütmesidir.
• Sonuçları kalıcı bir notebook oturumu değil, geçici analiz olarak ele alın.
• Yerel dosyalara veya çalışma alanınıza erişim olduğunu varsaymayın.
• Güncel X verileri için önce x_search kullanın ve sonucu code_execution içine aktarın.

İlgili