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

Tools

Búsqueda de Grok

OpenClaw admite Grok como proveedor web_search, que utiliza respuestas de xAI fundamentadas en la web para producir respuestas sintetizadas por IA respaldadas por resultados de búsqueda en tiempo real con citas.

La búsqueda web de Grok utiliza preferentemente un inicio de sesión OAuth de xAI existente cuando está disponible. Si no existe ningún perfil OAuth, la misma clave de API de xAI también permite utilizar la herramienta integrada x_search para buscar publicaciones en X (anteriormente Twitter) y la herramienta code_execution. Almacenar la clave en plugins.entries.xai.config.webSearch.apiKey también permite que OpenClaw la reutilice como alternativa para el proveedor de modelos xAI incluido.

Para obtener métricas de publicaciones concretas de X (republicaciones, respuestas, marcadores y visualizaciones), utilice x_search con la URL exacta de la publicación o el ID de estado, en lugar de una consulta de búsqueda amplia.

Incorporación y configuración

Elegir Grok durante openclaw onboard o openclaw configure --section web permite que OpenClaw reutilice un perfil OAuth de xAI existente sin solicitar una clave independiente para la búsqueda web. Sin OAuth, recurre a la configuración de una clave de API de xAI.

A continuación, OpenClaw ofrece un paso adicional para habilitar x_search con la misma credencial de xAI. Este paso adicional:

  • solo aparece después de elegir Grok para web_search
  • no es una opción independiente de proveedor de búsqueda web de nivel superior
  • puede configurar opcionalmente el modelo x_search en el mismo flujo

Omítalo para habilitar o cambiar x_search más adelante en la configuración.

Iniciar sesión u obtener una clave de API

  • Usar OAuth de xAI

    Si ya ha iniciado sesión en xAI durante la incorporación o la autenticación del modelo, elija Grok como proveedor web_search. No se requiere una clave de API independiente:

    bash
    openclaw onboard --auth-choice xai-oauthopenclaw config set tools.web.search.provider grok

  • Usar una clave de API como alternativa

    Obtenga una clave de API de xAI cuando OAuth no esté disponible o cuando desee expresamente una configuración de búsqueda web basada en una clave.

  • Almacenar la clave

    Establezca XAI_API_KEY en el entorno del Gateway o configure mediante:

    bash
    openclaw configure --section web

    • Configuración

    json5
    {  plugins: {    entries: {      xai: {        config: {          webSearch: {            apiKey: "xai-...", // opcional si están disponibles OAuth de xAI o XAI_API_KEY            baseUrl: "https://api.x.ai/v1", // anulación opcional de la URL base o del proxy de la API Responses          },        },      },    },  },  tools: {    web: {      search: {        provider: "grok",      },    },  },}

    Alternativas de credenciales: openclaw models auth login --provider xai --method oauth, XAI_API_KEY en el entorno del Gateway o plugins.entries.xai.config.webSearch.apiKey. Para una instalación del Gateway, coloque las variables de entorno en ~/.openclaw/.env.

    Funcionamiento

    Grok utiliza respuestas de xAI fundamentadas en la web para sintetizar respuestas con citas en línea, de forma similar al método de fundamentación con Google Search de Gemini.

    Parámetros compatibles

    La búsqueda de Grok admite query. Se acepta count por compatibilidad con web_search compartido, pero Grok siempre devuelve una única respuesta sintetizada con citas, en lugar de una lista de N resultados. No se admiten filtros específicos del proveedor.

    Grok utiliza de forma predeterminada un tiempo de espera de 60 segundos porque las búsquedas fundamentadas en la web de xAI Responses pueden tardar más que el valor predeterminado compartido de web_search. Anúlelo con tools.web.search.timeoutSeconds.

    Anulaciones de la URL base

    Establezca plugins.entries.xai.config.webSearch.baseUrl para dirigir la búsqueda web de Grok a través de un proxy del operador o un endpoint de Responses compatible con xAI. OpenClaw envía solicitudes POST a <baseUrl>/responses después de eliminar las barras diagonales finales. x_search utiliza como alternativa el mismo webSearch.baseUrl, a menos que se establezca plugins.entries.xai.config.xSearch.baseUrl.

    Temas relacionados

    Was this useful?
    On this page

    On this page