Wykonywanie kodu w OpenClaw (code_execution)

Wprowadzenie

Narzedzie code_execution uruchamia piaskownicowy (sandboxed) kod Python na infrastrukturze xAI Responses API. Rozni sie to od lokalnego narzedzia exec, ktore wykonuje polecenia powloki bezposrednio na Twojej maszynie.

Glowne zastosowania

Narzedzie code_execution sprawdza sie doskonale w nastepujacych scenariuszach:

• Obliczenia matematyczne — zlozzone kalkulacje, rownania, konwersje jednostek
• Tabelaryzacja danych — tworzenie przejrzystych tabel z danych wejsciowych
• Szybkie statystyki — srednie, mediany, odchylenia standardowe, korelacje
• Analiza wykresowa — generowanie wykresow i wizualizacji danych
• Przetwarzanie wynikow wyszukiwania — analiza danych pobranych przez x_search lub web_search

Kiedy nie uzywac

Narzedzie code_execution nie nadaje sie do pracy z lokalnymi plikami, powloka systemowa, repozytorium kodu ani sparowanymi urzadzeniami. W takich przypadkach nalezy uzyc narzedzia exec, ktore dziala bezposrednio na Twojej maszynie.

Konfiguracja

Wymagany jest klucz API xAI. Mozna go podac na dwa sposoby:

• Przez zmienna srodowiskowa XAI_API_KEY
• Przez konfiguracje plugins.entries.xai.config.webSearch.apiKey

Przykladowa konfiguracja:

{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast",
            maxTurns: 2,
            timeoutSeconds: 30,
          },
        },
      },
    },
  },
}

Wskazowki uzycia

Aby uzyskac najlepsze wyniki, nalezy jasno okreslac cel analityczny i wyraznie wskazywac uzycie narzedzia w promptach. Przyklady obejmuja obliczanie srednich kroczacych, zliczanie wynikow wyszukiwania wedlug okresow czasowych czy porownywanie danych benchmarkowych.

Wazne ograniczenia

• Kod wykonywany jest zdalnie na infrastrukturze xAI, nie lokalnie
• Traktuj wyniki jako tymczasowa analize — to nie jest srodowisko notebookowe
• Brak dostepu do lokalnych plikow ani zasobow workspace'u
• Do pozyskiwania aktualnych danych z platformy X uzyj x_search