Tools

Recherche Grok

OpenClaw prend en charge Grok comme fournisseur web_search, en utilisant les réponses xAI ancrées dans le web pour produire des réponses synthétisées par IA appuyées par des résultats de recherche en direct avec citations.

La recherche web Grok privilégie votre connexion OAuth xAI existante lorsqu’elle est disponible. Si aucun profil OAuth n’existe, la même clé d’API xAI peut aussi alimenter l’outil intégré x_search pour la recherche de publications X (anciennement Twitter) et l’outil code_execution. Si vous stockez la clé sous plugins.entries.xai.config.webSearch.apiKey, OpenClaw la réutilise également comme solution de secours pour le fournisseur de modèles xAI groupé.

Pour les métriques X au niveau d’une publication, comme les republications, les réponses, les signets ou les vues, préférez x_search avec l’URL exacte de la publication ou l’ID de statut plutôt qu’une requête de recherche large.

Intégration et configuration

Si vous choisissez Grok pendant :

openclaw onboard
openclaw configure --section web

OpenClaw peut utiliser un profil OAuth xAI existant sans demander de clé de recherche web distincte. Si OAuth n’est pas disponible, il revient à la configuration par clé d’API xAI. OpenClaw peut aussi afficher une étape de suivi distincte pour activer x_search avec le même identifiant xAI. Cette étape de suivi :

apparaît uniquement après que vous avez choisi Grok pour web_search
n’est pas un choix de fournisseur de recherche web de premier niveau distinct
peut facultativement définir le modèle x_search pendant le même flux

Si vous l’ignorez, vous pouvez activer ou modifier x_search plus tard dans la configuration.

Se connecter ou obtenir une clé d’API

Utiliser OAuth xAI

Si vous vous êtes déjà connecté avec xAI pendant l’intégration ou l’authentification du modèle, choisissez Grok comme fournisseur web_search. Aucune clé d’API distincte n’est requise :

bash

openclaw onboard --auth-choice xai-oauthopenclaw config set tools.web.search.provider grok

Utiliser une clé d’API de secours

Obtenez une clé d’API auprès de xAI lorsque OAuth n’est pas disponible ou que vous souhaitez intentionnellement une configuration de recherche web basée sur une clé.

Stocker la clé

Définissez XAI_API_KEY dans l’environnement Gateway, ou configurez-la via :

bash

openclaw configure --section web

Configuration

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",      },    },  },}

Autres options d’identification : connectez-vous avec openclaw models auth login --provider xai --method oauth, définissez XAI_API_KEY dans l’environnement Gateway, ou stockez plugins.entries.xai.config.webSearch.apiKey. Pour une installation Gateway, placez les variables d’environnement dans ~/.openclaw/.env.

Fonctionnement

Grok utilise les réponses xAI ancrées dans le web pour synthétiser des réponses avec citations intégrées, de façon similaire à l’approche d’ancrage Google Search de Gemini.

Paramètres pris en charge

La recherche Grok prend en charge query.

count est accepté pour la compatibilité partagée avec web_search, mais Grok renvoie toujours une réponse synthétisée avec citations plutôt qu’une liste de N résultats.

Les filtres propres au fournisseur ne sont pas pris en charge actuellement.

Grok utilise un délai d’expiration par défaut de 60 secondes propre au fournisseur, car les recherches xAI Responses ancrées dans le web peuvent prendre plus longtemps que la valeur par défaut partagée de web_search. Définissez tools.web.search.timeoutSeconds pour le remplacer.

Remplacements de l’URL de base

Définissez plugins.entries.xai.config.webSearch.baseUrl lorsque la recherche web Grok doit transiter par un proxy opérateur ou un point de terminaison Responses compatible xAI. OpenClaw publie vers <baseUrl>/responses après suppression des barres obliques finales. x_search utilise la même solution de secours webSearch.baseUrl sauf si plugins.entries.xai.config.xSearch.baseUrl est défini.