Tools

Ejecución de código

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

Propiedad	Valor
Nombre de herramienta	`code_execution`
Plugin proveedor	`xai` (incluido, `enabledByDefault: true`)
Autenticación	perfil de autenticación de xAI, `XAI_API_KEY`, o `plugins.entries.xai.config.webSearch.apiKey`
Modelo predeterminado	`grok-4-1-fast`
Tiempo de espera predeterminado	30 segundos
`maxTurns` predeterminado	sin definir (xAI aplica su propio límite interno)

Esto es distinto de exec local:

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

Usa code_execution para:

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

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

Configuración

Provide xAI credentials

Inicia sesión con Grok OAuth usando una suscripción elegible de SuperGrok o X Premium, o almacena una clave de API. OAuth de xAI usa verificación por código de dispositivo, por lo que funciona desde hosts remotos sin una devolución de llamada localhost. OAuth funciona para code_execution y x_search; XAI_API_KEY o la configuración de búsqueda web del Plugin también pueden activar web_search de Grok.

bash

openclaw models auth login --provider xai --method oauth

Durante una instalación nueva, las mismas opciones de autenticación están disponibles dentro de la incorporación:

bash

openclaw onboard --install-daemonopenclaw onboard --install-daemon --auth-choice xai-oauth

O usa una clave de API:

bash

openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...

O mediante configuración:

json5

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

Enable and tune code_execution

code_execution está disponible cuando hay credenciales de xAI disponibles. Define plugins.entries.xai.config.codeExecution.enabled como false para deshabilitarlo, o usa el mismo bloque para ajustar el modelo y el tiempo de espera.

json5

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

Restart the Gateway

bash

openclaw gateway restart

code_execution aparece en la lista de herramientas del agente una vez que el Plugin xAI se vuelve a registrar con enabled: true.

Cómo usarlo

Pide con naturalidad y deja explícita la intención del análisis:

text

Use code_execution to calculate the 7-day moving average for these numbers: ...

text

Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.

text

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 completa de análisis 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 al perfil de autenticación, la variable de entorno y las opciones de configuración. El error es JSON, no una excepción lanzada, por lo que el agente puede autocorregirse:

json

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

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 presupongas 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.