Saltar al contenido principal
code_execution ejecuta análisis remotos de Python en sandbox en la Responses API de xAI (https://api.x.ai/v1/responses, el mismo endpoint que usa x_search). Lo registra el plugin xai incluido bajo el contrato tools.
PropiedadValor
Nombre de herramientacode_execution
Plugin proveedorxai (incluido, enabledByDefault: true)
Autenticaciónperfil de autenticación de xAI, XAI_API_KEY o plugins.entries.xai.config.webSearch.apiKey
Modelo predeterminadogrok-4-1-fast
Tiempo de espera predeterminado30 segundos
maxTurns predeterminadosin definir (xAI aplica su propio límite interno)
Úsalo para cálculos, tabulación, estadísticas rápidas y análisis tipo gráfico, incluidos datos devueltos por x_search o web_search. No tiene acceso a archivos locales, tu shell, tu repositorio ni dispositivos emparejados, y no conserva estado entre llamadas, así que trata cada llamada como análisis efímero, no como una sesión de cuaderno. Para datos recientes de X, ejecuta primero x_search y pasa el resultado. Para ejecución local, usa exec en su lugar.

​
Configuración

1

Provide xAI credentials

OAuth requiere una suscripción SuperGrok o X Premium elegible (verificación con código de dispositivo, por lo que funciona desde hosts remotos sin callback de localhost):
openclaw models auth login --provider xai --method oauth
Durante una instalación nueva, la misma opción está disponible en el onboarding:
openclaw onboard --install-daemon --auth-choice xai-oauth
O una clave de API:
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
O mediante configuración:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
Cualquiera de estas tres opciones también habilita x_search y web_search de Grok.
2

Enable and tune code_execution

code_execution está disponible siempre que se resuelvan credenciales de xAI. Define plugins.entries.xai.config.codeExecution.enabled como false para deshabilitarlo, o usa el mismo bloque para sobrescribir el modelo, el límite de turnos o el tiempo de espera:
{
  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

Restart the Gateway

openclaw gateway restart
code_execution aparece en la lista de herramientas del agente cuando el plugin xAI se vuelve a registrar con enabled: true.

​
Cómo usarlo

Haz explícita la intención del análisis; la herramienta acepta un único parámetro task, así que envía la solicitud completa y cualquier dato en línea en un solo prompt: 
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.

​
Errores

Sin autenticación, la herramienta devuelve un error JSON estructurado (no una excepción lanzada), para que el agente pueda autocorregirse: 
{
  "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"
}

​
Relacionado

Exec tool

Ejecución de shell local en tu máquina o nodo emparejado.

Exec approvals

Política de permitir/denegar para la ejecución de shell.

Web tools

web_search, x_search y web_fetch.

xAI provider

Modelos Grok, búsqueda web/X y configuración de ejecución de código.