[Go to site: main page, start]
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 remoto de Python en un entorno aislado mediante la API Responses de xAI (https://api.x.ai/v1/responses, el mismo endpoint que usa x_search). Está registrado por el plugin xai incluido conforme al contrato tools.

Propiedad Valor
Nombre de la 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, tabulación, estadísticas rápidas y análisis con gráficos, incluidos los datos devueltos por x_search o web_search. No tiene acceso a archivos locales, al shell, al repositorio ni a dispositivos vinculados, y no conserva el estado entre llamadas, por lo que cada llamada debe tratarse como un análisis efímero, no como una sesión de cuaderno. Para obtener datos recientes de X, ejecute primero x_search y canalice el resultado.

Para la ejecución local, use exec en su lugar.

Configuración

  • Proporcionar credenciales de xAI

    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 incorporación:

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

    O bien, 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.

  • Habilitar y ajustar 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 distinto de 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 siempre son obligatorias.

    Use 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, // obligatorio para un proveedor conocido de modelos que no sea xAI            model: "grok-4.3", // sustituye el modelo predeterminado de ejecución de código de xAI            maxTurns: 2,            // límite opcional de turnos internos de herramientas            timeoutSeconds: 30,     // tiempo de espera de la solicitud (predeterminado: 30)          },        },      },    },  },}

  • Reiniciar el Gateway

    bash
    openclaw gateway restart

    code_execution aparece en la lista de herramientas del agente una vez que el plugin de xAI vuelve a registrarse y se superan las comprobaciones anteriores del proveedor, la habilitación y la autenticación.

    • Cómo usarla

    Indique explícitamente la intención del análisis; la herramienta acepta un único parámetro task, por lo que debe enviar la solicitud completa y todos los datos insertados en una sola instrucción:

    text
    Usa code_execution para calcular la media móvil de 7 días de estos números: ...
    text
    Usa x_search para buscar publicaciones que mencionen OpenClaw esta semana y después usa code_execution para contarlas por día.
    text
    Usa web_search para recopilar las cifras más recientes de pruebas comparativas de IA y después usa code_execution para comparar los cambios porcentuales.

    Errores

    Sin autenticación, la herramienta devuelve un error JSON estructurado (no una excepción generada), lo que permite al agente autocorregirse:

    json
    {  "error": "missing_xai_api_key",  "message": "code_execution necesita credenciales de xAI. Ejecuta `openclaw onboard --auth-choice xai-oauth` para iniciar sesión con Grok, ejecuta `openclaw onboard --auth-choice xai-api-key`, establece `XAI_API_KEY` en el entorno del Gateway o configura `plugins.entries.xai.config.webSearch.apiKey`.",  "docs": "https://docs.openclaw.ai/tools/code-execution"}

    Temas relacionados

    Herramienta Exec

    Ejecución local del shell en su máquina o Node vinculado.
    Aprobaciones de Exec

    Política de autorización o denegación para la ejecución del 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.
    Was this useful?
    On this page

    On this page