Busca do Grok

O OpenClaw oferece suporte ao Grok como provedor de web_search, usando respostas fundamentadas na web da xAI para produzir respostas sintetizadas por IA com base em resultados de busca ao vivo e citações.

A mesma XAI_API_KEY também pode alimentar a ferramenta integrada x_search para busca de publicações no X (antigo Twitter). Se você armazenar a chave em plugins.entries.xai.config.webSearch.apiKey, o OpenClaw agora a reutiliza como fallback também para o provedor de modelo xAI incluído.

Para métricas em nível de publicação do X, como republicações, respostas, favoritos ou visualizações, prefira x_search com a URL exata da publicação ou ID de status em vez de uma consulta de busca ampla.

# Onboarding e configuração

Se você escolher Grok durante:

• openclaw onboard
• openclaw configure --section web

O OpenClaw pode mostrar uma etapa de acompanhamento separada para habilitar x_search com a mesma XAI_API_KEY. Esse acompanhamento:

• aparece somente depois que você escolhe Grok para web_search
• não é uma opção separada de provedor de busca na web no nível superior
• pode opcionalmente definir o modelo de x_search durante o mesmo fluxo

Se você pular essa etapa, poderá habilitar ou alterar x_search depois na configuração.

# Obter uma chave de API

openclaw configure --section web

# Configuração

{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...", // optional if XAI_API_KEY is set
            baseUrl: "https://api.x.ai/v1", // optional Responses API proxy/base URL override
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "grok",
      },
    },
  },
}

Alternativa de ambiente: defina XAI_API_KEY no ambiente do Gateway. Para uma instalação do Gateway, coloque-a em ~/.openclaw/.env.

# Como funciona

O Grok usa respostas fundamentadas na web da xAI para sintetizar respostas com citações inline, de forma semelhante à abordagem de fundamentação com Google Search do Gemini.

# Parâmetros compatíveis

A busca do Grok oferece suporte a query.

count é aceito para compatibilidade compartilhada de web_search, mas o Grok ainda retorna uma resposta sintetizada com citações em vez de uma lista com N resultados.

Filtros específicos do provedor não são compatíveis no momento.

O Grok usa um timeout padrão específico do provedor de 60 segundos porque buscas fundamentadas na web com xAI Responses podem levar mais tempo que o padrão compartilhado de web_search. Defina tools.web.search.timeoutSeconds para sobrescrevê-lo.

# Substituições de URL base

Defina plugins.entries.xai.config.webSearch.baseUrl quando a busca na web do Grok precisar ser roteada por um proxy do operador ou endpoint compatível com xAI Responses. O OpenClaw envia a <baseUrl>/responses depois de remover barras finais. x_search usa o mesmo fallback de webSearch.baseUrl, a menos que plugins.entries.xai.config.xSearch.baseUrl esteja definido.

# Relacionado

• Visão geral da busca na web -- todos os provedores e detecção automática
• x_search na busca na web -- busca de primeira classe no X via xAI
• Busca do Gemini -- respostas sintetizadas por IA via fundamentação do Google