--- read_when: - Quieres usar modelos de Grok en OpenClaw - Estás configurando la autenticación o los identificadores de modelos de xAI summary: Usa los modelos Grok de xAI en OpenClaw title: xAI x-i18n: generated_at: "2026-07-11T23:28:53Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: eba797fbb2f4f2a47c8e07daabe93ef4f6e5a8077d3c739b0f6b9c99283995e1 source_path: providers/xai.md workflow: 16 --- OpenClaw incluye un Plugin de proveedor `xai` integrado para los modelos Grok. La opción recomendada es OAuth de Grok con una suscripción apta de SuperGrok o X Premium. El Gateway, la configuración, el enrutamiento y las herramientas permanecen locales; solo las solicitudes de Grok se envían a la API de xAI. OAuth no requiere una clave de API de xAI ni la aplicación Grok Build. Es posible que xAI siga mostrando Grok Build en la pantalla de consentimiento porque OpenClaw utiliza el cliente OAuth compartido de xAI. ## Configuración Ejecuta la incorporación con la instalación del daemon y selecciona OAuth de xAI/Grok en el paso de modelo/autenticación: ```bash openclaw onboard --install-daemon ``` En un VPS o mediante SSH, selecciona directamente OAuth de xAI; utiliza verificación mediante código de dispositivo y no necesita una devolución de llamada a localhost: ```bash openclaw onboard --install-daemon --auth-choice xai-oauth ``` Inicia sesión únicamente en xAI; no vuelvas a ejecutar toda la incorporación solo para conectar Grok: ```bash openclaw models auth login --provider xai --method oauth ``` Establece Grok como modelo predeterminado por separado: ```bash openclaw models set xai/grok-4.3 ``` Vuelve a ejecutar toda la incorporación solo si quieres cambiar intencionadamente el Gateway, el daemon, el canal, el espacio de trabajo u otras opciones de configuración. La configuración con clave de API sigue funcionando con las claves de xAI Console y con las superficies multimedia que necesitan una configuración del proveedor respaldada por una clave: ```bash openclaw models auth login --provider xai --method api-key export XAI_API_KEY=xai-... ``` ```json5 { agents: { defaults: { model: { primary: "xai/grok-4.3" } } }, } ``` OpenClaw utiliza la API Responses de xAI como transporte integrado de xAI. La misma credencial de `openclaw models auth login --provider xai --method oauth` o `--method api-key` también permite usar `web_search` (id. de proveedor `grok`), `x_search`, `code_execution`, voz/transcripción y la generación de imágenes y vídeos de xAI. Si almacenas una clave de xAI en `plugins.entries.xai.config.webSearch.apiKey`, el proveedor integrado de modelos de xAI también la reutiliza como alternativa. ## Solución de problemas de OAuth - Para SSH, Docker, VPS u otras configuraciones remotas, utiliza `openclaw models auth login --provider xai --method oauth`; emplea verificación mediante código de dispositivo, no una devolución de llamada a localhost. - Si el inicio de sesión se completa correctamente, pero Grok no es el modelo predeterminado, ejecuta `openclaw models set xai/grok-4.3`. - Inspecciona los perfiles de autenticación de xAI guardados: ```bash openclaw models auth list --provider xai openclaw models status ``` - xAI decide qué cuentas pueden recibir tokens de API mediante OAuth. Si una cuenta no es apta, utiliza la opción con clave de API o comprueba la suscripción en xAI. Utiliza `xai-oauth` al iniciar sesión desde SSH, Docker o un VPS. OpenClaw muestra una URL y un código corto; completa el inicio de sesión en cualquier navegador local mientras el proceso remoto consulta periódicamente a xAI hasta que finalice el intercambio del token. ## Catálogo integrado Identificadores seleccionables en los selectores de modelos. El Plugin aún resuelve los identificadores antiguos de Grok 3, Grok 4, Grok 4 Fast, Grok 4.1 Fast y Grok Code para las configuraciones existentes; consulta [compatibilidad heredada y alias variables](#legacy-compatibility-and-moving-aliases). | Familia | Identificadores de modelo | | -------------- | ------------------------------------------------------------ | | Grok 4.5 | `grok-4.5` (alias: `grok-4.5-latest`, `grok-build-latest`) | | Grok Build 0.1 | `grok-build-0.1` | | Grok 4.3 | `grok-4.3` (alias: `grok-4.3-latest`, `grok-latest`) | | Grok 4.20 | `grok-4.20-0309-reasoning`, `grok-4.20-0309-non-reasoning` | Utiliza `grok-4.5` para chat general, programación y trabajo con agentes donde esté disponible. Grok 4.3 continúa siendo el valor predeterminado de configuración seguro entre regiones; `grok-build-0.1` y las dos variantes fechadas de Grok 4.20 siguen siendo seleccionables. ## Cobertura de funcionalidades El Plugin integrado asigna las API compatibles de xAI a los contratos compartidos de proveedores y herramientas de OpenClaw. Las capacidades que no se ajustan al contrato compartido se enumeran a continuación o en las limitaciones conocidas. | Capacidad de xAI | Superficie de OpenClaw | Estado | | ----------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------- | | Chat / Responses | Proveedor de modelos `xai/` | Sí | | Búsqueda web en el servidor | Proveedor `grok` de `web_search` | Sí | | Búsqueda en X en el servidor | Herramienta `x_search` | Sí | | Ejecución de código en el servidor | Herramienta `code_execution` | Sí | | Imágenes | `image_generate` | Sí | | Vídeos | `video_generate` | Flujo de trabajo clásico completo; imagen a vídeo con Video 1.5 | | Texto a voz por lotes | `messages.tts.provider: "xai"` / `tts` | Sí | | TTS en streaming | - | El proveedor de xAI aún no lo ha implementado | | Voz a texto por lotes | Comprensión multimedia `tools.media.audio`| Sí | | Voz a texto en streaming | Llamada de voz `streaming.provider: "xai"`| Sí | | Voz en tiempo real | - | Aún no está expuesta; necesita otro contrato de sesión/WebSocket | | Archivos / lotes | Solo compatibilidad con API genérica de modelos | No es una herramienta de OpenClaw de primera clase | OpenClaw utiliza las API REST de imágenes, vídeos, TTS y STT de xAI para la generación multimedia y la transcripción por lotes, el WebSocket de STT en streaming de xAI para la transcripción de llamadas de voz en directo, y la API Responses para chat, búsqueda y herramientas de ejecución de código. ### Compatibilidad heredada del modo rápido `/fast on` o `agents.defaults.models["xai/"].params.fastMode: true` siguen transformando las configuraciones antiguas de xAI de la siguiente forma. Estos identificadores de destino se conservan únicamente por compatibilidad; utiliza los modelos seleccionables actuales para las configuraciones nuevas. | Modelo de origen | Destino del modo rápido | | ---------------- | ----------------------- | | `grok-3` | `grok-3-fast` | | `grok-3-mini` | `grok-3-mini-fast` | | `grok-4` | `grok-4-fast` | | `grok-4-0709` | `grok-4-fast` | ### Compatibilidad heredada y alias variables Los alias antiguos se normalizan de la siguiente forma: | Alias heredado | Id. normalizado | | ------------------------------------------------------------- | ----------------- | | `grok-code-fast-1`, `grok-code-fast`, `grok-code-fast-1-0825` | `grok-build-0.1` | Los identificadores fechados 0309 son las entradas seleccionables del catálogo. OpenClaw envía literalmente todos los demás alias actuales de Grok 4.20 para que xAI conserve el control de la semántica de los alias estables, más recientes, beta, experimentales y fechados. El alias global `grok-latest` también se conserva literalmente. xAI retiró los siguientes identificadores exactos. OpenClaw los conserva como filas de compatibilidad ocultas para las configuraciones publicadas, con los límites y precios de sus destinos de redirección actuales: | Identificadores retirados | Comportamiento actual | | --------------------------------------------------------------------- | ---------------------------------------- | | `grok-4-1-fast-reasoning`, `grok-4-fast-reasoning`, `grok-4-0709` | Grok 4.3 con razonamiento `low` | | `grok-4-1-fast-non-reasoning`, `grok-4-fast-non-reasoning`, `grok-3` | Grok 4.3 con el razonamiento desactivado | | `grok-code-fast-1` | Grok Build 0.1 | | `grok-imagine-image-pro` | Grok Imagine Image Quality | `openclaw doctor --fix` actualiza los valores predeterminados persistentes de las herramientas de servidor de xAI y el identificador retirado de imagen de calidad, elimina las filas obsoletas del catálogo generado y corrige los metadatos de contexto obsoletos de las filas 4.20 activas. No fija los alias activos `beta-latest` de 4.20 a una instantánea fechada. ## Funcionalidades `x_search` y `code_execution` se ejecutan en los servidores de xAI. xAI cobra 5 USD por cada 1000 llamadas a herramientas, además de los tokens de entrada y salida del modelo. Si se omite la opción `enabled` de cada herramienta, OpenClaw solo la expone para un modelo de xAI activo. Un proveedor de modelos conocido que no sea xAI requiere un `enabled: true` explícito por herramienta; un proveedor ausente o sin resolver impide la activación. La autenticación de xAI siempre es obligatoria y `enabled: false` desactiva la herramienta para todos los proveedores. El proveedor integrado de búsqueda web `grok` da prioridad a OAuth de xAI y, como alternativa, utiliza `XAI_API_KEY` o una clave de búsqueda web del Plugin: ```bash openclaw models auth login --provider xai --method oauth openclaw config set tools.web.search.provider grok ``` El Plugin `xai` integrado registra la generación de vídeos mediante la herramienta compartida `video_generate`. - Modelo predeterminado: `xai/grok-imagine-video` - Modelo adicional: `xai/grok-imagine-video-1.5` - Modos clásicos: texto a vídeo, imagen a vídeo, generación con imágenes de referencia, edición remota de vídeo y extensión remota de vídeo - Modo Video 1.5: solo imagen a vídeo, con exactamente una imagen para el primer fotograma - Relaciones de aspecto: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`; al omitirla, tanto el modo clásico como el modo imagen a vídeo de Video 1.5 heredan la relación de la imagen de origen - Resoluciones: `480P`/`720P` en el modo clásico; Video 1.5 también admite `1080P`; todos los modos de generación usan `480P` de forma predeterminada - Duración: de 1 a 15 segundos para generación/imagen a vídeo, de 1 a 10 segundos al utilizar roles clásicos `reference_image` y de 2 a 10 segundos para la extensión clásica - Generación con imágenes de referencia: establece `imageRoles` en `reference_image` para cada imagen proporcionada; xAI acepta hasta 7 imágenes de este tipo - La edición/extensión de vídeo hereda la relación de aspecto y la resolución del vídeo de entrada; esas operaciones no aceptan sustituciones de geometría - Tiempo de espera predeterminado de la operación: 600 segundos, salvo que se defina `video_generate.timeoutMs` o `agents.defaults.videoGenerationModel.timeoutMs` No se aceptan búferes de vídeo locales. Utiliza URL `http(s)` remotas para las entradas de edición/extensión de vídeo. El modo imagen a vídeo acepta búferes de imágenes locales porque OpenClaw los codifica como URL de datos para xAI. Video 1.5 también reconoce los identificadores `grok-imagine-video-1.5-preview` y `grok-imagine-video-1.5-2026-05-30` de xAI. OpenClaw reenvía el identificador seleccionado sin modificarlo, pero aplica la misma validación exclusiva para imágenes. Para utilizar xAI como proveedor de vídeo predeterminado: ```json5 { agents: { defaults: { videoGenerationModel: { primary: "xai/grok-imagine-video", }, }, }, } ``` Consulta [Generación de vídeos](/es/tools/video-generation) para conocer los parámetros compartidos de la herramienta, la selección de proveedores y el comportamiento de conmutación por error. 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-quality` - Modos: texto a imagen y edición de imagen de referencia - Entradas de referencia: una `image` o hasta tres `images` - Relaciones de aspecto: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2`, `19.5:9`, `9:19.5`, `20:9`, `9:20` - Resoluciones: `1K`, `2K` - Cantidad: hasta 4 imágenes - Tiempo de espera predeterminado de la operación: 600 segundos, salvo que se configure `image_generate.timeoutMs` o `agents.defaults.imageGenerationModel.timeoutMs` OpenClaw solicita a xAI respuestas de imagen `b64_json` para que los archivos multimedia generados puedan almacenarse y entregarse mediante la ruta normal de archivos adjuntos del canal. Las imágenes de referencia locales se convierten en URL de datos; las referencias remotas `http(s)` se transmiten sin cambios. Para usar xAI como proveedor de imágenes predeterminado: ```json5 { agents: { defaults: { imageGenerationModel: { primary: "xai/grok-imagine-image", }, }, }, } ``` xAI también documenta `quality`, `mask`, `user` y una relación de aspecto `auto`. Actualmente, OpenClaw solo reenvía los controles de imagen compartidos entre proveedores; estos ajustes exclusivos del proveedor nativo no están disponibles mediante `image_generate`. El Plugin `xai` incluido registra la conversión de texto a voz mediante la interfaz compartida del proveedor `tts`. - Voces: catálogo activo autenticado de xAI; consúltelo con `openclaw infer tts voices --provider xai` - Voces alternativas sin conexión: `ara`, `eve`, `leo`, `rex`, `sal` - Voz predeterminada: `eve` - Los identificadores de voces personalizadas de la cuenta se reenvían incluso cuando no aparecen en la respuesta del catálogo integrado - Formatos: `mp3`, `wav`, `pcm`, `mulaw`, `alaw` - Idioma: código BCP-47 o `auto` - Velocidad: ajuste de velocidad nativo del proveedor - No se admite el formato nativo de nota de voz Opus Para usar xAI como proveedor TTS predeterminado: ```json5 { messages: { tts: { provider: "xai", providers: { xai: { voiceId: "eve", }, }, }, }, } ``` OpenClaw utiliza el punto de conexión por lotes `/v1/tts` de xAI y el catálogo autenticado `/v1/tts/voices`. xAI también ofrece TTS en streaming mediante WebSocket, pero el proveedor xAI incluido aún no implementa ese enlace de streaming. El Plugin `xai` incluido registra la conversión de voz a texto por lotes mediante la interfaz de transcripción de comprensión multimedia de OpenClaw. - Punto de conexión: REST `/v1/stt` de xAI - Ruta de entrada: carga de archivo de audio multiparte - Selección de modelo: xAI elige internamente el modelo de transcripción; el punto de conexión no dispone de selector de modelo - Se utiliza dondequiera que la transcripción de audio entrante lea `tools.media.audio`, incluidos los segmentos de canales de voz de Discord y los archivos adjuntos de audio de los canales Para forzar el uso de xAI en la transcripción de audio entrante: ```json5 { tools: { media: { audio: { models: [ { type: "provider", provider: "xai", }, ], }, }, }, } ``` El idioma puede proporcionarse mediante la configuración compartida de medios de audio o en cada solicitud de transcripción. La interfaz compartida de OpenClaw acepta indicaciones para el prompt, pero la integración REST STT de xAI solo reenvía el archivo y el idioma, ya que son los únicos que se corresponden con el punto de conexión público actual de xAI. El Plugin `xai` incluido también registra un proveedor de transcripción en tiempo real para el audio de llamadas de voz en directo. - Punto de conexión: WebSocket `wss://api.x.ai/v1/stt` de xAI - Codificación predeterminada: `mulaw` - Frecuencia de muestreo predeterminada: `8000` - Detección predeterminada del final de la intervención: `800ms` - Transcripciones provisionales: activadas de forma predeterminada El flujo multimedia de Twilio de Voice Call envía tramas de audio G.711 mu-law, por lo que el proveedor xAI reenvía esas tramas directamente sin transcodificarlas: ```json5 { 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`. Este proveedor de streaming se utiliza para la ruta de transcripción en tiempo real de Voice Call. La función de voz de Discord graba segmentos cortos y utiliza en su lugar la ruta de transcripción por lotes `tools.media.audio`. 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` | Clave | Tipo | Valor predeterminado | Descripción | | ----------------- | ------- | -------------------------- | ------------------------------------------------------------- | | `enabled` | boolean | Automático para modelos xAI | Desactivar o habilitar para un proveedor conocido que no sea xAI | | `model` | string | `grok-4.3` | Modelo utilizado para las solicitudes de x_search | | `baseUrl` | string | - | Sustitución de la URL base de Responses de xAI | | `inlineCitations` | boolean | - | Incluir citas en línea en los resultados | | `maxTurns` | number | - | Número máximo de turnos de conversación | | `timeoutSeconds` | number | `30` | Tiempo de espera de la solicitud en segundos | | `cacheTtlMinutes` | number | `15` | Tiempo de vida de la caché en minutos | ```json5 { plugins: { entries: { xai: { config: { xSearch: { enabled: true, model: "grok-4.3", baseUrl: "https://api.x.ai/v1", inlineCitations: true, }, }, }, }, }, } ``` El Plugin xAI incluido expone `code_execution` como una herramienta de OpenClaw para ejecutar código de forma remota en el entorno aislado de xAI. Ruta de configuración: `plugins.entries.xai.config.codeExecution` | Clave | Tipo | Valor predeterminado | Descripción | | ---------------- | ------- | -------------------------- | ------------------------------------------------------------- | | `enabled` | boolean | Automático para modelos xAI | Desactivar o habilitar para un proveedor conocido que no sea xAI | | `model` | string | `grok-4.3` | Modelo utilizado para las solicitudes de ejecución de código | | `maxTurns` | number | - | Número máximo de turnos de conversación | | `timeoutSeconds` | number | `30` | Tiempo de espera de la solicitud en segundos | Esta es una ejecución remota en el entorno aislado de xAI, no el comando local [`exec`](/es/tools/exec). ```json5 { plugins: { entries: { xai: { config: { codeExecution: { enabled: true, model: "grok-4.3", }, }, }, }, }, } ``` - La autenticación de xAI puede utilizar una clave de API, una variable de entorno, la configuración alternativa del Plugin u OAuth con una cuenta de xAI apta. OAuth utiliza la verificación mediante código de dispositivo sin devolución de llamada a localhost. xAI decide qué cuentas pueden recibir tokens de API OAuth, y la página de consentimiento puede mostrar Grok Build aunque OpenClaw no requiera la aplicación Grok Build. - Actualmente, OpenClaw no expone la familia de modelos multiagente de xAI. xAI sirve estos modelos mediante la API Responses, pero no aceptan las herramientas del lado del cliente ni las personalizadas que utiliza el bucle de agente compartido de OpenClaw. Consulte las [limitaciones multiagente de xAI](https://docs.x.ai/developers/model-capabilities/text/multi-agent#limitations). - La voz en tiempo real de xAI aún no está registrada como proveedor de OpenClaw. Requiere un contrato de sesión de voz bidireccional distinto al de STT por lotes o la transcripción en streaming. - Las opciones de imagen `quality`, `mask` y la relación de aspecto nativa `auto` de xAI no estarán disponibles hasta que la herramienta compartida `image_generate` disponga de los controles correspondientes entre proveedores. - OpenClaw aplica automáticamente correcciones de compatibilidad específicas de xAI para los esquemas y las llamadas de herramientas en la ruta del ejecutor compartido. - Las solicitudes nativas de xAI usan `tool_stream: true` de forma predeterminada. Establezca `agents.defaults.models["xai/"].params.tool_stream` en `false` para desactivarlo. - El contenedor de xAI incluido elimina los límites no admitidos del recuento de elementos contenidos en los esquemas y las claves no admitidas de *esfuerzo* de razonamiento de las cargas antes de enviar solicitudes nativas de xAI. Grok 4.5 admite esfuerzo bajo, medio y alto (alto de forma predeterminada). Grok 4.3 admite ningún esfuerzo, bajo, medio y alto (bajo de forma predeterminada). Otros modelos de xAI con capacidad de razonamiento no exponen un control configurable del esfuerzo, pero aun así solicitan `include: ["reasoning.encrypted_content"]` para que el razonamiento cifrado anterior pueda reutilizarse en turnos posteriores. - `web_search`, `x_search` y `code_execution` se exponen como herramientas de OpenClaw. OpenClaw adjunta a la solicitud de cada herramienta únicamente la función integrada específica de xAI que esa herramienta necesita, 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 utiliza como alternativa la URL base de búsqueda web de Grok. - `x_search` y `code_execution` pertenecen al Plugin xAI incluido, en lugar de estar codificados directamente en el entorno de ejecución de modelos del núcleo. - `code_execution` es una ejecución remota en el entorno aislado de xAI, no el comando local [`exec`](/es/tools/exec). ## Pruebas en directo Las rutas multimedia de xAI están cubiertas por pruebas unitarias y conjuntos de pruebas en directo opcionales. Exporte `XAI_API_KEY` en el entorno del proceso antes de ejecutar las comprobaciones en directo. ```bash pnpm test extensions/xai OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 pnpm test:live -- extensions/xai/xai.live.test.ts OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_XAI_VIDEO=1 pnpm test:live -- extensions/xai/xai.live.test.ts -t "classic Grok Imagine" OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_XAI_VIDEO=1 pnpm test:live -- extensions/xai/xai.live.test.ts -t "Grok Imagine Video 1.5" OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 pnpm test:live -- extensions/xai/x-search.live.test.ts OPENCLAW_LIVE_GATEWAY_MODELS="xai/grok-4.5,xai/grok-build-0.1,xai/grok-4.3,xai/grok-4.20-0309-reasoning,xai/grok-4.20-0309-non-reasoning" OPENCLAW_LIVE_GATEWAY_MAX_MODELS=0 OPENCLAW_LIVE_GATEWAY_SMOKE=0 pnpm test:live -- src/gateway/gateway-models.profiles.live.test.ts OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 OPENCLAW_LIVE_IMAGE_GENERATION_PROVIDERS=xai pnpm test:live -- test/image-generation.runtime.live.test.ts ``` El archivo de pruebas en vivo específico del proveedor sintetiza TTS normal, TTS PCM apto para telefonía, transcribe audio mediante STT por lotes de xAI, transmite el mismo PCM mediante STT en tiempo real de xAI, genera resultados de texto a imagen y edita una imagen de referencia. El archivo compartido de pruebas en vivo de imágenes verifica el mismo proveedor xAI mediante la selección en tiempo de ejecución, la conmutación por error, la normalización y la ruta de adjuntos multimedia de OpenClaw. El caso opcional de Video 1.5 envía una imagen generada como primer fotograma a 1080P y verifica la descarga del vídeo completado. ## Relacionado Elección de proveedores, referencias de modelos y comportamiento de conmutación por error. Parámetros de la herramienta de vídeo compartida y selección de proveedores. Descripción general más amplia de los proveedores. Problemas comunes y soluciones.