Tools
Kod yürütme
code_execution, xAI'ın Responses API'sinde (https://api.x.ai/v1/responses,
x_search tarafından kullanılanla aynı uç nokta) korumalı alanda uzaktan Python
analizi çalıştırır. 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 (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, tablolaştırma, hızlı istatistikler ve grafik tarzı analizler için;
x_search veya web_search tarafından döndürülen veriler de dahil 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ı olarak saklamaz; 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
aktararak kullanın.
Yerel yürütme için bunun yerine exec kullanın.
Kurulum
Provide xAI credentials
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 oauthYeni bir kurulum sırasında aynı seçenek ilk katılım sürecinde kullanılabilir:
openclaw onboard --install-daemon --auth-choice xai-oauthVeya bir API anahtarıyla:
openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...Ya da yapılandırma aracılığıyla:
{ plugins: { entries: { xai: { config: { webSearch: { apiKey: "xai-...", }, }, }, }, },}Bu üç yöntemin tümü x_search ve Grok web_search için de kimlik bilgisi
sağlar.
Enable and tune code_execution
enabled belirtilmediğinde code_execution, yalnızca etkin modelin
sağlayıcısı xai olduğunda ve xAI kimlik bilgileri çözümlenebildiğinde
sunulur. Sağlayıcısı bilinen ve xAI olmayan 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 modelin sağlayıcısı eksikse veya çözümlenemiyorsa araç gizli
kalır. Aracı tüm sağlayıcılarda devre dışı bırakmak için 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, // required for a known non-xAI model provider model: "grok-4.3", // override the default xAI code-execution model maxTurns: 2, // optional cap on internal tool turns timeoutSeconds: 30, // request timeout (default: 30) }, }, }, }, },}Restart the Gateway
openclaw gateway restartxAI Plugin'i yeniden kaydolduğunda ve yukarıdaki sağlayıcı, etkinleştirme ve
kimlik doğrulama denetimleri başarılı olduğunda code_execution, ajanın araç
listesinde görünür.
Nasıl kullanılır?
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:
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.Hatalar
Kimlik doğrulama olmadan araç, fırlatılan bir istisna yerine yapılandırılmış bir JSON hatası döndürür; böylece ajan kendi kendine düzeltme yapabilir:
{ "error": "missing_xai_api_key", "message": "code_execution needs xAI credentials. Run `openclaw onboard --auth-choice xai-oauth` to sign in with Grok, 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"}