Wykonywanie kodu

code_execution uruchamia analizę w Pythonie w izolowanym zdalnym środowisku na Responses API xAI. Jest rejestrowane przez dołączony Plugin xai (w ramach kontraktu tools) i wysyła żądania do tego samego endpointu https://api.x.ai/v1/responses, którego używa x_search.

Różni się to od lokalnego exec:

• exec uruchamia polecenia powłoki na Twoim komputerze lub sparowanym węźle.
• code_execution uruchamia Pythona w zdalnym sandboxie xAI.

Używaj code_execution do:

• Obliczeń.
• Tworzenia tabel.
• Szybkich statystyk.
• Analiz 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

export XAI_API_KEY=xai-...

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

{
  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)
          },
        },
      },
    },
  },
}

openclaw gateway restart

# Jak go używać

Pytaj naturalnie i jasno określ cel 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 jeden parametr task, więc agent powinien wysłać pełne żądanie analizy oraz wszelkie dane wbudowane w jednym prompcie.

# Błędy

Gdy narzędzie działa bez uwierzytelniania, zwraca ustrukturyzowany błąd missing_xai_api_key, wskazujący zmienną środowiskową i ścieżkę konfiguracji. Błąd jest JSON-em, a nie zgłoszonym wyjątkiem, więc agent może samodzielnie go poprawić:

{
  "error": "missing_xai_api_key",
  "message": "code_execution needs an 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 lokalne wykonywanie procesu.
• Traktuj wyniki jako efemeryczną analizę, a nie trwałą sesję notatnika.
• Nie zakładaj dostępu do plików lokalnych ani swojego obszaru roboczego.
• Dla świeżych danych z X najpierw użyj x_search, a następnie przekaż wynik do code_execution.

# Powiązane