Kod yürütme

code_execution, xAI'nin Responses API'sinde sandbox içinde uzak Python analizi çalıştırır. Paketle gelen xai Plugin'i tarafından (tools sözleşmesi altı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 kabuk komutları çalıştırır.
• code_execution, Python'u xAI'nin uzak sandbox'ında çalıştırır.

code_execution aracını şunlar için kullanın:

• 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, kabuğunuza, 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", // override the default xAI code-execution model
            maxTurns: 2,            // optional cap on internal tool turns
            timeoutSeconds: 30,     // request timeout (default: 30)
          },
        },
      },
    },
  },
}

openclaw gateway restart

# Nasıl kullanılır

Doğal şekilde isteyin 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 aracın tam analiz isteğini ve satır içi verileri tek bir istemde göndermesi gerekir.

# Hatalar

Araç kimlik doğrulama olmadan çalıştığında, ortam değişkenini ve yapılandırma yolunu gösteren yapılandırılmış bir missing_xai_api_key hatası döndürür. Hata JSON'dur, fırlatılan bir istisna değildir; bu nedenle araç kendini düzeltebilir:

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

# Sınırlar

• Bu, yerel süreç yürütmesi değil, uzak xAI yürütmesidir.
• Sonuçları kalıcı bir not defteri 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