xAI

El proveedor de búsqueda web grok integrado puede usar XAI_API_KEY o una clave de búsqueda web del Plugin:

openclaw config set tools.web.search.provider grok

El Plugin xai integrado registra la generación de vídeo mediante la herramienta compartida video_generate.

• Modelo de vídeo predeterminado: xai/grok-imagine-video
• Modos: texto a vídeo, imagen a vídeo, generación con imagen de referencia, edición de vídeo remoto y extensión de vídeo remoto
• Relaciones de aspecto: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• Resoluciones: 480P, 720P
• Duración: 1-15 segundos para generación/imagen a vídeo, 1-10 segundos al usar roles reference_image, 2-10 segundos para extensión
• Generación con imagen de referencia: configura imageRoles como reference_image para cada imagen proporcionada; xAI acepta hasta 7 imágenes de este tipo

Para usar xAI como proveedor de vídeo predeterminado:

{  agents: {    defaults: {      videoGenerationModel: {        primary: "xai/grok-imagine-video",      },    },  },}

El Plugin xai integrado registra la generación de imágenes mediante la herramienta compartida image_generate.

• Modelo de imagen predeterminado: xai/grok-imagine-image
• Modelo adicional: xai/grok-imagine-image-pro
• Modos: texto a imagen y edición con imagen de referencia
• Entradas de referencia: una image o hasta cinco images
• Relaciones de aspecto: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Resoluciones: 1K, 2K
• Recuento: hasta 4 imágenes

OpenClaw solicita a xAI respuestas de imagen b64_json para que los medios generados puedan almacenarse y entregarse mediante la ruta normal de adjuntos de canal. Las imágenes de referencia locales se convierten en URL de datos; las referencias http(s) remotas se transmiten sin cambios.

Para usar xAI como proveedor de imágenes predeterminado:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "xai/grok-imagine-image",      },    },  },}

El Plugin xai integrado registra texto a voz mediante la superficie de proveedor tts compartida.

• Voces: eve, ara, rex, sal, leo, una
• Voz predeterminada: eve
• Formatos: mp3, wav, pcm, mulaw, alaw
• Idioma: código BCP-47 o auto
• Velocidad: anulación de velocidad nativa del proveedor
• El formato nativo Opus de nota de voz no es compatible

Para usar xAI como proveedor TTS predeterminado:

{  messages: {    tts: {      provider: "xai",      providers: {        xai: {          voiceId: "eve",        },      },    },  },}

El Plugin xai integrado registra voz a texto por lotes mediante la superficie de transcripción de comprensión de medios de OpenClaw.

• Modelo predeterminado: grok-stt
• Endpoint: REST de xAI /v1/stt
• Ruta de entrada: carga de archivo de audio multipart
• Compatible en OpenClaw dondequiera que la transcripción de audio entrante use tools.media.audio, incluidos segmentos de canales de voz de Discord y adjuntos de audio de canales

Para forzar xAI para la transcripción de audio entrante:

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",            model: "grok-stt",          },        ],      },    },  },}

El idioma puede proporcionarse mediante la configuración compartida de medios de audio o por solicitud de transcripción individual. La superficie compartida de OpenClaw acepta indicaciones de prompt, pero la integración STT REST de xAI solo reenvía archivo, modelo e idioma porque se asignan claramente al endpoint público actual de xAI.

El Plugin xai integrado también registra un proveedor de transcripción en tiempo real para audio de llamadas de voz en vivo.

• Endpoint: WebSocket de xAI wss://api.x.ai/v1/stt
• Codificación predeterminada: mulaw
• Frecuencia de muestreo predeterminada: 8000
• Detección de finalización predeterminada: 800ms
• Transcripciones provisionales: habilitadas de forma predeterminada

El flujo de medios de Twilio de Voice Call envía tramas de audio G.711 µ-law, por lo que el proveedor de xAI puede reenviar esas tramas directamente sin transcodificación:

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "xai",            providers: {              xai: {                apiKey: "${XAI_API_KEY}",                endpointingMs: 800,                language: "en",              },            },          },        },      },    },  },}

La configuración propiedad del proveedor se encuentra en plugins.entries.voice-call.config.streaming.providers.xai. Las claves admitidas son apiKey, baseUrl, sampleRate, encoding (pcm, mulaw o alaw), interimResults, endpointingMs y language.

El Plugin xAI incluido expone x_search como una herramienta de OpenClaw para buscar contenido de X (antes Twitter) mediante Grok.

Ruta de configuración: plugins.entries.xai.config.xSearch

{  plugins: {    entries: {      xai: {        config: {          xSearch: {            enabled: true,            model: "grok-4-1-fast",            baseUrl: "https://api.x.ai/v1",            inlineCitations: true,          },        },      },    },  },}

El Plugin xAI incluido expone code_execution como una herramienta de OpenClaw para la ejecución remota de código en el entorno sandbox de xAI.

Ruta de configuración: plugins.entries.xai.config.codeExecution

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4-1-fast",          },        },      },    },  },}

• Actualmente, la autenticación solo admite clave de API. La clave de API se puede almacenar en un perfil de autenticación de xAI, una variable de entorno o la configuración del Plugin; todavía no hay OAuth de xAI ni flujo de código de dispositivo en OpenClaw.
• grok-4.20-multi-agent-experimental-beta-0304 no es compatible con la ruta normal del proveedor xAI porque requiere una superficie de API ascendente distinta de la del transporte xAI estándar de OpenClaw.
• La voz en tiempo real de xAI todavía no está registrada como proveedor de OpenClaw. Necesita un contrato de sesión de voz bidireccional distinto del STT por lotes o la transcripción por streaming.
• La quality de imagen de xAI, el mask de imagen y las relaciones de aspecto adicionales solo nativas no se exponen hasta que la herramienta compartida image_generate tenga los controles correspondientes entre proveedores.

• OpenClaw aplica automáticamente correcciones de compatibilidad específicas de xAI para esquemas de herramientas y llamadas a herramientas en la ruta del ejecutor compartido.
• Las solicitudes nativas de xAI usan tool_stream: true de forma predeterminada. Define agents.defaults.models["xai/<model>"].params.tool_stream como false para deshabilitarlo.
• El wrapper xAI incluido elimina marcas estrictas de esquemas de herramientas no admitidas y claves de payload de razonamiento antes de enviar solicitudes nativas de xAI.
• web_search, x_search y code_execution se exponen como herramientas de OpenClaw. OpenClaw habilita la función integrada específica de xAI que necesita dentro de cada solicitud de herramienta, en lugar de adjuntar todas las herramientas nativas a cada turno de chat.
• web_search de Grok lee plugins.entries.xai.config.webSearch.baseUrl. x_search lee plugins.entries.xai.config.xSearch.baseUrl y luego recurre a la URL base de búsqueda web de Grok.
• x_search y code_execution son propiedad del Plugin xAI incluido, en lugar de estar codificados de forma rígida en el runtime del modelo principal.
• code_execution es ejecución remota en el sandbox de xAI, no exec local.