Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw oferece suporte ao Grok como provedor de web_search, usando respostas da xAI fundamentadas na web para produzir respostas sintetizadas por IA com base em resultados de busca em tempo real com citações. A mesma chave de API da xAI também pode alimentar a ferramenta x_search integrada para busca de posts no X (anteriormente Twitter) e a ferramenta code_execution. Se você armazenar a chave em plugins.entries.xai.config.webSearch.apiKey, o OpenClaw agora a reutiliza também como fallback para o provedor de modelo xAI incluído. Para métricas de posts individuais no X, como reposts, respostas, favoritos ou visualizações, prefira x_search com a URL exata do post ou o 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 complementar separada para habilitar x_search com a mesma XAI_API_KEY. Essa etapa complementar:
  • só aparece depois que você escolhe Grok para web_search
  • não é uma escolha separada de provedor de busca web de nível superior
  • pode opcionalmente definir o modelo de x_search durante o mesmo fluxo
Se você a ignorar, poderá habilitar ou alterar x_search mais tarde na configuração.

​
Obter uma chave de API

1

Criar uma chave

Obtenha uma chave de API da xAI.
2

Armazenar a chave

Defina XAI_API_KEY no ambiente do Gateway ou configure via:
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 da xAI fundamentadas na web para sintetizar respostas com citações inline, semelhante à abordagem de fundamentação da Busca Google 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 demorar mais que o padrão compartilhado de web_search. Defina tools.web.search.timeoutSeconds para substituí-lo.

​
Substituições de URL base

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

​
Relacionado