Przejdź do głównej treści
code_execution uruchamia zdalną analizę w Pythonie w piaskownicy w Responses API xAI. Jest rejestrowane przez dołączony Plugin xai (w ramach kontraktu tools) i wysyła żądania do tego samego punktu końcowego https://api.x.ai/v1/responses, którego używa x_search.
WłaściwośćWartość
Nazwa narzędziacode_execution
Plugin dostawcyxai (dołączony, enabledByDefault: true)
Uwierzytelnianieprofil uwierzytelniania xAI, XAI_API_KEY lub plugins.entries.xai.config.webSearch.apiKey
Domyślny modelgrok-4-1-fast
Domyślny limit czasu30 sekund
Domyślne maxTurnsnieustawione (xAI stosuje własny limit wewnętrzny)
Różni się to od lokalnego exec:
  • exec uruchamia polecenia powłoki na Twojej maszynie lub sparowanym węźle.
  • code_execution uruchamia Pythona w zdalnej piaskownicy xAI.
Używaj code_execution do:
  • Obliczeń.
  • Tabelaryzacji.
  • Szybkich statystyk.
  • Analizy w stylu wykresów.
  • Analizowania danych zwróconych przez x_search lub web_search.
Nie używaj go, gdy potrzebujesz plików lokalnych, swojej powłoki, swojego repozytorium lub sparowanych urządzeń. Do tego użyj exec.

​
Konfiguracja

1

Podaj dane logowania xAI

Zaloguj się przez OAuth Grok przy użyciu kwalifikującej się subskrypcji SuperGrok lub X Premium albo zapisz klucz API. OAuth xAI używa weryfikacji kodem urządzenia, więc działa ze zdalnych hostów bez wywołania zwrotnego localhost. OAuth działa dla code_execution i x_search; XAI_API_KEY lub konfiguracja wyszukiwania web w Pluginie może również zasilać Grok web_search.
openclaw models auth login --provider xai --method oauth
Podczas świeżej instalacji te same opcje uwierzytelniania są dostępne w onboardingu:
openclaw onboard --install-daemon
openclaw onboard --install-daemon --auth-choice xai-oauth
Albo użyj klucza API:
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
Albo przez konfigurację:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

Włącz i dostrój code_execution

code_execution jest dostępne, gdy dostępne są dane logowania xAI. Ustaw plugins.entries.xai.config.codeExecution.enabled na false, aby je wyłączyć, albo użyj tego samego bloku, aby dostroić model i limit czasu.
{
  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)
          },
        },
      },
    },
  },
}
3

Uruchom ponownie Gateway

openclaw gateway restart
code_execution pojawia się na liście narzędzi agenta, gdy Plugin xAI ponownie zarejestruje się z enabled: true.

​
Jak go używać

Pytaj naturalnie i jasno określ intencję analizy: 
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.
Narzędzie wewnętrznie przyjmuje pojedynczy parametr task, więc agent powinien wysłać pełną prośbę o analizę i wszystkie dane inline w jednym prompcie.

​
Błędy

Gdy narzędzie działa bez uwierzytelniania, zwraca ustrukturyzowany błąd missing_xai_api_key, wskazując opcje profilu uwierzytelniania, zmiennej środowiskowej i konfiguracji. Błąd jest JSON-em, a nie rzuconym wyjątkiem, więc agent może sam się poprawić: 
{
  "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"
}

​
Limity

  • To jest zdalne wykonywanie xAI, a nie wykonywanie lokalnego procesu.
  • Traktuj wyniki jako efemeryczną analizę, a nie trwałą sesję notatnika.
  • Nie zakładaj dostępu do plików lokalnych ani swojego obszaru roboczego.
  • Aby uzyskać świeże dane X, najpierw użyj x_search, a następnie przekaż wynik do code_execution.

​
Powiązane

Narzędzie exec

Lokalne wykonywanie powłoki na Twojej maszynie lub sparowanym węźle.

Zatwierdzenia exec

Zasady zezwalania/odmawiania dla wykonywania powłoki.

Narzędzia web

web_search, x_search i web_fetch.

Dostawca xAI

Modele Grok, wyszukiwanie web/X i konfiguracja wykonywania kodu.