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 live con citazioni.

La ricerca web di Grok preferisce il tuo accesso OAuth xAI esistente quando è disponibile. Se non esiste alcun profilo OAuth, la stessa chiave API xAI può anche alimentare lo strumento x_search integrato 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 la riutilizza anche come fallback per il provider di modelli xAI incluso.

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

Onboarding e configurazione

Se scegli Grok durante:

  • openclaw onboard
  • openclaw configure --section web

OpenClaw può usare un profilo OAuth xAI esistente senza richiedere una chiave di ricerca web separata. Se OAuth non è disponibile, passa alla configurazione con chiave API xAI. OpenClaw può anche mostrare un passaggio successivo separato per abilitare x_search con la stessa credenziale xAI. Questo passaggio successivo:

  • appare solo dopo che hai 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 più tardi nella configurazione.

Accedi o ottieni una chiave API

  • Usa OAuth xAI

    Se hai già effettuato l'accesso con xAI durante l'onboarding o l'autenticazione del modello, scegli Grok come provider web_search. Non è richiesta alcuna chiave API separata:

    bash
    openclaw onboard --auth-choice xai-oauthopenclaw config set tools.web.search.provider grok
  • Usa un fallback con chiave API

    Ottieni una chiave API da xAI quando OAuth non è disponibile o vuoi intenzionalmente una configurazione di ricerca web basata su chiave.

  • Archivia la chiave

    Imposta XAI_API_KEY nell'ambiente Gateway, oppure configura tramite:

    bash
    openclaw configure --section web
  • Configurazione

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

    Alternative per le credenziali: accedi con openclaw models auth login --provider xai --method oauth, imposta XAI_API_KEY nell'ambiente Gateway, oppure archivia plugins.entries.xai.config.webSearch.apiKey. Per un'installazione Gateway, inserisci le variabili d'ambiente 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 di Ricerca Google di Gemini.

    Parametri supportati

    La ricerca Grok supporta query.

    count è accettato per la compatibilità condivisa di web_search, ma Grok restituisce comunque una singola risposta sintetizzata con citazioni anziché 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 durare più a lungo del valore predefinito condiviso di web_search. Imposta tools.web.search.timeoutSeconds per sovrascriverlo.

    Override dell'URL base

    Imposta plugins.entries.xai.config.webSearch.baseUrl quando la ricerca web 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 plugins.entries.xai.config.xSearch.baseUrl non sia impostato.

    Correlati

    Was this useful?
    On this page

    On this page