Ejecución de código

code_execution ejecuta análisis remoto de Python en entorno aislado en la API Responses de xAI. Lo registra el Plugin incluido xai (bajo el contrato tools) y se despacha al mismo endpoint https://api.x.ai/v1/responses que usa x_search.

Esto es diferente del exec local:

• exec ejecuta comandos de shell en tu máquina o nodo emparejado.
• code_execution ejecuta Python en el entorno aislado remoto de xAI.

Usa code_execution para:

• Cálculos.
• Tabulación.
• Estadísticas rápidas.
• Análisis tipo gráfico.
• Analizar datos devueltos por x_search o web_search.

No lo uses cuando necesites archivos locales, tu shell, tu repositorio o dispositivos emparejados. Usa exec para eso.

# Configuración

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

# Cómo usarlo

Pregunta con naturalidad y haz explícita la intención del análisis:

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.

La herramienta toma internamente un único parámetro task, por lo que el agente debe enviar la solicitud de análisis completa y cualquier dato en línea en un solo prompt.

# Errores

Cuando la herramienta se ejecuta sin autenticación, devuelve un error estructurado missing_xai_api_key que apunta a la variable de entorno y a la ruta de configuración. El error es JSON, no una excepción lanzada, por lo que el agente puede autocorregirse:

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

# Límites

• Esto es ejecución remota de xAI, no ejecución de procesos locales.
• Trata los resultados como análisis efímero, no como una sesión persistente de notebook.
• No asumas acceso a archivos locales ni a tu espacio de trabajo.
• Para datos recientes de X, usa primero x_search y canaliza el resultado a code_execution.

# Relacionado