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 onboardopenclaw 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_searchdurante 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:
openclaw onboard --auth-choice xai-oauthopenclaw config set tools.web.search.provider grokUsa 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:
openclaw configure --section webConfigurazione
{ 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
- Panoramica di Web Search -- tutti i provider e il rilevamento automatico
- x_search in Web Search -- ricerca X di prima classe tramite xAI
- Ricerca Gemini -- risposte sintetizzate dall'AI tramite grounding di Google