xAI

El proveedor de búsqueda web grok integrado también usa XAI_API_KEY:

openclaw config set tools.web.search.provider grok

El Plugin xai integrado registra la generación de video mediante la herramienta compartida video_generate.

• Modelo de video predeterminado: xai/grok-imagine-video
• Modos: texto a video, imagen a video, generación con imagen de referencia, edición de video remota y extensión de video remota
• 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 video, 1-10 segundos cuando se usan roles reference_image, 2-10 segundos para extensión
• Generación con imagen de referencia: configura imageRoles como reference_image para cada imagen suministrada; xAI acepta hasta 7 imágenes de este tipo

Para usar xAI como proveedor de video 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
• Cantidad: 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 del canal. Las imágenes de referencia locales se convierten en URL de datos; las referencias http(s) remotas se transfieren directamente.

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 compartida de proveedor tts.

• 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 multimedia de OpenClaw.

• Modelo predeterminado: grok-stt
• Endpoint: REST de xAI /v1/stt
• Ruta de entrada: carga de archivo de audio multipart
• Compatible en OpenClaw allí donde la transcripción de audio entrante usa 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 suministrarse mediante la configuración multimedia de audio compartida o mediante una solicitud de transcripción por llamada. La superficie compartida de OpenClaw acepta pistas de prompt, pero la integración REST STT de xAI solo reenvía archivo, modelo e idioma porque se asignan limpiamente 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
• Endpointing predeterminado: 800ms
• Transcripciones provisionales: habilitadas de forma predeterminada

El flujo multimedia de Twilio de Voice Call envía tramas de audio G.711 µ-law, por lo que el proveedor 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 vive 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 de 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 de xAI incluido expone code_execution como una herramienta de OpenClaw para 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",
          },
        },
      },
    },
  },
}

• La autenticación hoy solo usa clave de API. Todavía no hay flujo de OAuth ni de código de dispositivo de xAI en OpenClaw.
• grok-4.20-multi-agent-experimental-beta-0304 no es compatible con la ruta normal del proveedor de xAI porque requiere una superficie de API ascendente distinta al transporte xAI estándar de OpenClaw.
• La voz de xAI Realtime aún no está registrada como proveedor de OpenClaw. Necesita un contrato de sesión de voz bidireccional distinto al de STT por lotes o transcripción en streaming.
• La quality de imagen de xAI, la mask de imagen y las relaciones de aspecto adicionales solo nativas no se exponen hasta que la herramienta compartida image_generate tenga 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. Establece agents.defaults.models["xai/<model>"].params.tool_stream en false para deshabilitarlo.
• El wrapper de xAI incluido elimina indicadores strict de esquema de herramientas no compatibles 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 el componente integrado específico 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 pertenecen al Plugin de xAI incluido en lugar de estar codificados directamente en el runtime del modelo principal.
• code_execution es ejecución remota en el sandbox de xAI, no exec local.