Kod yürütme

code_execution, xAI’nin Responses API’sinde korumalı alanda uzaktan Python analizi çalıştırır (https://api.x.ai/v1/responses, x_search tarafından kullanılan uç noktayla aynı). Paketle birlikte gelen xai Plugin’i tarafından tools sözleşmesi kapsamında kaydedilir.

code_execution, xAI sunucularında çalışır. xAI, modelin giriş ve çıkış tokenlerine ek olarak her 1.000 araç çağrısı için $5 ücret alır.

Özellik	Değer
Araç adı	`code_execution`
Sağlayıcı Plugin’i	`xai` (paketle birlikte gelir, `enabledByDefault: true`)
Kimlik doğrulama	xAI kimlik doğrulama profili, `XAI_API_KEY` veya `plugins.entries.xai.config.webSearch.apiKey`
Varsayılan model	`grok-4.3`
Varsayılan zaman aşımı	30 saniye
Varsayılan `maxTurns`	ayarlanmamış (xAI kendi dahili sınırını uygular)

Hesaplamalar, tablolama, hızlı istatistikler ve grafik tarzı analizler için, x_search veya web_search tarafından döndürülen veriler dâhil olmak üzere kullanın. Yerel dosyalara, kabuğunuza, deponuza veya eşleştirilmiş cihazlara erişimi yoktur ve çağrılar arasında durumu kalıcı hâle getirmez; bu nedenle her çağrıyı bir not defteri oturumu değil, geçici bir analiz olarak değerlendirin. Güncel X verileri için önce x_search çalıştırın ve sonucu aktarın. Yerel yürütme için bunun yerine exec kullanın.

Kurulum

xAI kimlik bilgilerini sağlayın

OAuth, uygun bir SuperGrok veya X Premium aboneliği gerektirir (cihaz koduyla doğrulama kullandığından localhost geri çağrısı olmadan uzak ana makinelerden çalışır):

openclaw models auth login --provider xai --method oauth

Yeni bir kurulum sırasında aynı seçenek ilk katılım akışında da kullanılabilir:

openclaw onboard --install-daemon --auth-choice xai-oauth

Veya bir API anahtarı:

openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...

Ya da yapılandırma aracılığıyla:

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

Bu üç seçeneğin tümü x_search ve Grok web_search özelliklerini de çalıştırır.

code_execution'ı etkinleştirin ve ayarlayın

enabled belirtilmediğinde code_execution, yalnızca etkin modelin sağlayıcısı xai olduğunda ve xAI kimlik bilgileri çözümlendiğinde kullanıma sunulur. Sağlayıcısı xAI olmadığı bilinen etkin bir modelde, sağlayıcılar arası kullanımı etkinleştirmek için plugins.entries.xai.config.codeExecution.enabled değerini true olarak ayarlayın. Etkin model sağlayıcısı eksikse veya çözümlenemiyorsa araç gizli kalır. Tüm sağlayıcılar için devre dışı bırakmak üzere enabled değerini false olarak ayarlayın. xAI kimlik bilgileri her zaman gereklidir.Modeli, tur sınırını veya zaman aşımını geçersiz kılmak için aynı bloğu kullanın:

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

Gateway'i yeniden başlatın

openclaw gateway restart

xAI Plugin’i yeniden kaydolduktan ve yukarıdaki sağlayıcı, etkinleştirme ve kimlik doğrulama denetimleri geçildikten sonra code_execution, ajanın araç listesinde görünür.

Kullanımı

Analiz amacını açıkça belirtin; araç tek bir task parametresi alır, bu nedenle isteğin tamamını ve satır içi verileri tek bir istemde gönderin:

Bu sayıların 7 günlük hareketli ortalamasını hesaplamak için 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 güncel yapay zekâ kıyaslama sayılarını toplamak için web_search kullan, ardından yüzdelik değişimleri karşılaştırmak için code_execution kullan.

Hatalar

Kimlik doğrulama olmadan araç, oluşturulan bir istisna yerine yapılandırılmış bir JSON hatası döndürür; böylece ajan kendi kendine 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` komutunu çalıştırın, `openclaw onboard --auth-choice xai-api-key` komutunu çalıştırın, Gateway ortamında `XAI_API_KEY` değişkenini ayarlayın veya `plugins.entries.xai.config.webSearch.apiKey` değerini yapılandırın.",
  "docs": "https://docs.openclaw.ai/tools/code-execution"
}

İlgili

Exec aracı

Makinenizde veya eşleştirilmiş Node üzerinde yerel kabuk yürütme.

Exec onayları

Kabuk yürütme için izin verme/reddetme ilkesi.

Web araçları

web_search, x_search ve web_fetch.

xAI sağlayıcısı

Grok modelleri, web/X araması ve kod yürütme yapılandırması.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Kurulum

Kullanımı

Hatalar

İlgili

Exec aracı

Exec onayları

Web araçları

xAI sağlayıcısı

​Kurulum

​Kullanımı

​Hatalar

​İlgili

Exec aracı

Exec onayları

Web araçları

xAI sağlayıcısı

Kurulum

Kullanımı

Hatalar

İlgili