OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Ejecución de código

code_execution ejecuta análisis remotos de Python en un entorno aislado mediante la API Responses de xAI (https://api.x.ai/v1/responses, el mismo endpoint que utiliza x_search). Lo registra el plugin xai incluido mediante el contrato tools.

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.3
Tiempo de espera predeterminado 30 segundos
maxTurns predeterminado sin establecer (xAI aplica su propio límite interno)

Úselo para cálculos, tabulaciones, estadísticas rápidas y análisis de tipo gráfico, incluidos los datos devueltos por x_search o web_search. No tiene acceso a archivos locales, al shell, al repositorio ni a dispositivos emparejados, y no conserva el estado entre llamadas; por tanto, trate cada llamada como un análisis efímero, no como una sesión de cuaderno. Para obtener datos recientes de X, ejecute primero x_search y pase el resultado.

Para la ejecución local, utilice exec.

Configuración

  • Provide xAI credentials

    OAuth requiere una suscripción válida a SuperGrok o X Premium (verificación mediante código de dispositivo, por lo que funciona desde hosts remotos sin una devolución de llamada a localhost):

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

    Durante una instalación nueva, la misma opción está disponible en la configuración inicial:

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

    O mediante una clave de API:

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

    O mediante la configuración:

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

    Cualquiera de estas tres opciones también permite utilizar x_search y web_search de Grok.

  • Enable and tune code_execution

    Si se omite enabled, code_execution solo se expone cuando el proveedor del modelo activo es xai y se pueden resolver las credenciales de xAI. Para un modelo activo con un proveedor conocido que no sea xAI, establezca plugins.entries.xai.config.codeExecution.enabled en true para habilitar el uso entre proveedores. Si falta el proveedor del modelo activo o no se puede resolver, la herramienta permanece oculta. Establezca enabled en false para deshabilitarla para todos los proveedores. Las credenciales de xAI son siempre obligatorias.

    Utilice el mismo bloque para sustituir el modelo, el límite de turnos o el tiempo de espera:

    json5
    {  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true, // required for a known non-xAI model provider            model: "grok-4.3", // 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 cuando el plugin de xAI vuelve a registrarse y se superan las comprobaciones anteriores del proveedor, la habilitación y la autenticación.

    • Cómo utilizarla

    Indique explícitamente la finalidad del análisis; la herramienta acepta un único parámetro task, por lo que debe enviar la solicitud completa y todos los datos en línea en un solo prompt:

    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.

    Errores

    Sin autenticación, la herramienta devuelve un error JSON estructurado (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"}

    Contenido relacionado

    Exec tool

    Ejecución del shell local en su equipo o nodo emparejado.
    Exec approvals

    Política de autorización o denegación para la ejecución del shell.
    Web tools

    web_search, x_search y web_fetch.
    xAI provider

    Modelos Grok, búsquedas web/X y configuración de ejecución de código.
    Was this useful?
    On this page

    On this page