Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

code_execution ejecuta análisis de Python remoto en sandbox en la API Responses de xAI. Lo registra el plugin xai incluido (bajo el contrato tools) y se despacha al mismo endpoint https://api.x.ai/v1/responses que usa x_search.
PropiedadValor
Nombre de la herramientacode_execution
Plugin de 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 establecer (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 repositorio o dispositivos emparejados. Usa exec para eso.

​
Configuración

1

Proporciona una clave de API de xAI

Run openclaw onboard --auth-choice xai-api-key for code_execution and x_search, or set XAI_API_KEY / configure the key under the xAI plugin when you also want Grok web search to use the same credential:
export XAI_API_KEY=xai-...
O mediante configuración:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

Habilita y ajusta code_execution

La herramienta está controlada por plugins.entries.xai.config.codeExecution.enabled. El valor predeterminado es desactivado.
{
  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

Reinicia el Gateway

openclaw gateway restart
code_execution aparece en la lista de herramientas del agente una vez que el plugin xAI vuelve a registrarse con enabled: true.

​
Cómo usarlo

Pide de forma natural y explicita 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, así 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: 
{
  "error": "missing_xai_api_key",
  "message": "code_execution needs an xAI API key. 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 asumas acceso a archivos locales ni a tu área de trabajo.
  • Para datos recientes de X, usa primero x_search y canaliza el resultado a code_execution.

​
Relacionado

Herramienta Exec

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

Aprobaciones de exec

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

Herramientas web

web_search, x_search y web_fetch.

Proveedor xAI

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