Ana içeriğe atla
code_execution, xAI’nin Responses API’sinde sandbox’lı uzak Python analizi çalıştırır. Paketle gelen xai plugin 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 yönlendirir.
ÖzellikDeğer
Araç adıcode_execution
Sağlayıcı pluginxai (paketle gelen, enabledByDefault: true)
Kimlik doğrulamaxAI auth profili, XAI_API_KEY veya plugins.entries.xai.config.webSearch.apiKey
Varsayılan modelgrok-4-1-fast
Varsayılan zaman aşımı30 saniye
Varsayılan maxTurnsayarlanmamış (xAI kendi dahili sınırını uygular)
Bu, yerel exec aracından farklıdır:
  • exec, makinenizde veya eşleştirilmiş node üzerinde kabuk komutları çalıştırır.
  • code_execution, xAI’nin uzak sandbox’ında Python çalıştırır.
code_execution aracını şunlar için kullanın:
  • Hesaplamalar.
  • Tablolama.
  • 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

1

xAI kimlik bilgilerini sağlayın

Uygun bir SuperGrok veya X Premium aboneliği kullanarak Grok OAuth ile oturum açın ya da bir API anahtarı saklayın. xAI OAuth, cihaz kodu doğrulaması kullanır, bu nedenle localhost geri çağrısı olmadan uzak ana makinelerden çalışır. OAuth, code_execution ve x_search için çalışır; XAI_API_KEY veya plugin web-search yapılandırması Grok web_search için de güç sağlayabilir.
openclaw models auth login --provider xai --method oauth
Yeni bir kurulum sırasında aynı kimlik doğrulama seçenekleri onboarding içinde de kullanılabilir:
openclaw onboard --install-daemon
openclaw onboard --install-daemon --auth-choice xai-oauth
Veya bir API anahtarı kullanın:
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
Ya da config üzerinden:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

code_execution öğesini etkinleştirin ve ayarlayın

xAI kimlik bilgileri mevcut olduğunda code_execution kullanılabilir. Devre dışı bırakmak için plugins.entries.xai.config.codeExecution.enabled değerini false olarak ayarlayın veya modeli ve zaman aşımını ayarlamak için aynı bloğu kullanın.
{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast", // varsayılan xAI code-execution modelini geçersiz kıl
            maxTurns: 2,            // dahili araç turları için isteğe bağlı üst sınır
            timeoutSeconds: 30,     // istek zaman aşımı (varsayılan: 30)
          },
        },
      },
    },
  },
}
3

Gateway'i yeniden başlatın

openclaw gateway restart
xAI plugin enabled: true ile yeniden kaydolduğunda code_execution, agent’ın araç listesinde görünür.

​
Nasıl kullanılır

Doğal şekilde sorun ve analiz amacını açıkça belirtin: 
Bu sayılar için 7 günlük hareketli ortalamayı hesaplamak üzere code_execution kullan: ...

Bu hafta OpenClaw'dan bahseden gönderileri bulmak için x_search kullan, ardından bunları güne göre saymak için code_execution kullan.

En son AI benchmark sayılarını toplamak için web_search kullan, ardından yüzde değişimlerini karşılaştırmak için code_execution kullan.
Araç dahili olarak tek bir task parametresi alır, bu nedenle agent tam analiz isteğini ve varsa satır içi verileri tek bir prompt içinde göndermelidir.

​
Hatalar

Araç kimlik doğrulaması olmadan çalıştığında, auth profili, env var ve config seçeneklerine 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’dur; bu nedenle agent kendi kendini düzeltebilir: 
{
  "error": "missing_xai_api_key",
  "message": "code_execution için xAI kimlik bilgileri gerekir. Grok ile oturum açmak için `openclaw onboard --auth-choice xai-oauth` çalıştırın, `openclaw onboard --auth-choice xai-api-key` çalıştırın, Gateway ortamında `XAI_API_KEY` ayarlayın veya `plugins.entries.xai.config.webSearch.apiKey` yapılandırın.",
  "docs": "https://docs.openclaw.ai/tools/code-execution"
}

​
Sınırlar

  • Bu, yerel process yürütme değil, uzak xAI yürütmesidir.
  • Sonuçları kalıcı bir notebook oturumu olarak değil, geçici analiz olarak değerlendirin.
  • Yerel dosyalara veya workspace’inize 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

Exec aracı

Makinenizde veya eşleştirilmiş node üzerinde yerel shell yürütme.

Exec onayları

Shell yürütmesi için izin ver/reddet politikası.

Web araçları

web_search, x_search ve web_fetch.

xAI sağlayıcısı

Grok modelleri, web/x search ve code execution config.