Tools

Ricerca Grok

OpenClaw supporta Grok come provider web_search, usando risposte xAI basate sul web per produrre risposte sintetizzate dall'AI supportate da risultati di ricerca in tempo reale con citazioni.

La stessa chiave API xAI può anche alimentare lo strumento integrato x_search per la ricerca di post su X (precedentemente Twitter) e lo strumento code_execution. Se archivi la chiave in plugins.entries.xai.config.webSearch.apiKey, OpenClaw ora la riutilizza anche come fallback per il provider di modelli xAI incluso.

Per metriche di X a livello di post, come ripubblicazioni, risposte, segnalibri o visualizzazioni, preferisci x_search con l'URL esatto del post o l'ID di stato invece di una query di ricerca ampia.

Onboarding e configurazione

Se scegli Grok durante:

  • openclaw onboard
  • openclaw configure --section web

OpenClaw può mostrare un passaggio successivo separato per abilitare x_search con lo stesso XAI_API_KEY. Quel passaggio successivo:

  • appare solo dopo aver scelto Grok per web_search
  • non è una scelta separata di provider di ricerca web di primo livello
  • può facoltativamente impostare il modello x_search durante lo stesso flusso

Se lo salti, puoi abilitare o modificare x_search in seguito nella configurazione.

Ottieni una chiave API

  • Create a key

    Ottieni una chiave API da xAI.

  • Store the key

    Imposta XAI_API_KEY nell'ambiente del Gateway, oppure configura tramite:

    bash
    openclaw configure --section web
  • Configurazione

    json5
    {  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 tramite ambiente: imposta XAI_API_KEY nell'ambiente del Gateway. Per un'installazione del gateway, inseriscila in ~/.openclaw/.env.

    Come funziona

    Grok usa risposte xAI basate sul web per sintetizzare risposte con citazioni inline, in modo simile all'approccio di grounding con Google Search di Gemini.

    Parametri supportati

    La ricerca Grok supporta query.

    count è accettato per la compatibilità condivisa con web_search, ma Grok restituisce comunque una singola risposta sintetizzata con citazioni invece di un elenco di N risultati.

    I filtri specifici del provider non sono attualmente supportati.

    Grok usa un timeout predefinito specifico del provider di 60 secondi perché le ricerche xAI Responses basate sul web possono richiedere più tempo rispetto al valore predefinito condiviso di web_search. Imposta tools.web.search.timeoutSeconds per sovrascriverlo.

    Override dell'URL di base

    Imposta plugins.entries.xai.config.webSearch.baseUrl quando la ricerca web di Grok deve passare attraverso un proxy dell'operatore o un endpoint Responses compatibile con xAI. OpenClaw invia richieste POST a <baseUrl>/responses dopo aver rimosso le barre finali. x_search usa lo stesso fallback webSearch.baseUrl a meno che non sia impostato plugins.entries.xai.config.xSearch.baseUrl.

    Correlati

    Was this useful?