---
read_when:
- Quieres habilitar o configurar code_execution
- Quieres análisis remoto sin acceso local al shell
- Quieres combinar x_search o web_search con análisis remoto en Python
summary: 'code_execution: ejecutar análisis remoto de Python en entorno aislado con xAI'
title: Ejecución de código
x-i18n:
generated_at: "2026-06-27T17:10:17Z"
model: gpt-5.5
postprocess_version: locale-links-v1
provider: openai
source_hash: d510d0d2b41deab527d456e675a23ef80ac3b55b5f01906ba2c43d90e4452e36
source_path: tools/code-execution.md
workflow: 16
---
`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`](/es/tools/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`](/es/tools/exec) para eso.
## Configuración
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-daemon
openclaw onboard --install-daemon --auth-choice xai-oauth
```
O usa una clave de API:
```bash
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
```
O mediante configuración:
```json5
{
plugins: {
entries: {
xai: {
config: {
webSearch: {
apiKey: "xai-...",
},
},
},
},
},
}
```
`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)
},
},
},
},
},
}
```
```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`](/es/tools/web#x_search) y canaliza el resultado a `code_execution`.
## Relacionado
Ejecución de shell local en tu máquina o nodo emparejado.
Política de permitir/denegar para la ejecución de shell.
`web_search`, `x_search` y `web_fetch`.
Modelos Grok, búsqueda web/X y configuración de ejecución de código.