Tools

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.

Ö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):

bash

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:

bash

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

Veya bir API anahtarı:

bash

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

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

json5

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

json5

{  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

bash

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:

text

Bu sayıların 7 günlük hareketli ortalamasını hesaplamak için code_execution kullan: ...

text

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.

text

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:

json

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