Skip to main content
Le Plugin Parallel fournit deux fournisseurs web_search Parallel, qui renvoient tous deux des extraits classés et optimisés pour les LLM à partir d’un index web conçu pour les agents d’IA : Définissez tools.web.search.provider sur parallel-free ou parallel pour en sélectionner explicitement un ; aucun des deux n’est détecté automatiquement.
Les modèles OpenAI Responses directs (api: "openai-responses", fournisseur openai, URL de base de l’API officielle) utilisent automatiquement la recherche web native hébergée d’OpenAI lorsque tools.web.search.provider n’est pas défini, est vide ou vaut "auto" ou "openai" ; ils contournent donc Parallel par défaut. Définissez tools.web.search.provider sur parallel-free ou parallel pour les acheminer plutôt via Parallel. Consultez la présentation de la recherche web.

​
Installer le Plugin

​
Clé API (fournisseur payant)

parallel-free ne nécessite aucune clé, mais doit tout de même être sélectionné explicitement. Le fournisseur payant parallel nécessite une clé API :
1

Créer un compte

Inscrivez-vous sur platform.parallel.ai et générez une clé API depuis votre tableau de bord.
2

Enregistrer la clé

Définissez PARALLEL_API_KEY dans l’environnement du Gateway, ou configurez-la avec :

​
Configuration

Autre possibilité avec une variable d’environnement : définissez PARALLEL_API_KEY dans l’environnement du Gateway. Pour une installation du Gateway, placez-la dans ~/.openclaw/.env.

​
Remplacement de l’URL de base

S’applique uniquement au fournisseur payant parallel ; parallel-free utilise toujours https://search.parallel.ai/mcp et ignore ce paramètre. Définissez plugins.entries.parallel.config.webSearch.baseUrl pour acheminer les requêtes payantes via un proxy compatible ou un autre point de terminaison (par exemple, Cloudflare AI Gateway). OpenClaw normalise les hôtes sans protocole en ajoutant https:// et ajoute /v1/search, sauf si le chemin se termine déjà ainsi. Le point de terminaison résolu fait partie de la clé du cache de recherche ; les résultats provenant de points de terminaison différents ne sont donc jamais partagés.

​
Paramètres de l’outil

Les deux fournisseurs exposent le format de recherche natif de Parallel afin que le modèle renseigne un objectif en langage naturel ainsi que quelques courtes requêtes par mots-clés, combinaison que Parallel recommande pour obtenir les meilleurs résultats.
​
string
requis
Description en langage naturel de la question ou de l’objectif sous-jacent (5 000 caractères maximum). Elle doit être autonome.
​
string[]
requis
Requêtes de recherche concises par mots-clés, de 3 à 6 mots chacune (1 à 5 entrées, 200 caractères maximum chacune). Fournissez 2 à 3 requêtes variées pour obtenir les meilleurs résultats.
​
number
Nombre de résultats à renvoyer (1 à 40).
​
string
Identifiant de session Parallel facultatif provenant du sessionId d’un résultat précédent. Transmettez-le lors des recherches suivantes de la même tâche afin que Parallel regroupe les appels associés et améliore les résultats ultérieurs. Maximum de 1 000 caractères avec parallel ; le Search MCP gratuit parallel-free le limite à 100. Un identifiant dépassant la limite est supprimé (version payante) ou remplacé par un nouvel identifiant (version gratuite).
​
string
Identifiant facultatif du modèle effectuant l’appel (par exemple claude-opus-4-7 ou gpt-5.6-sol), de 100 caractères maximum. Il permet à Parallel d’adapter les paramètres par défaut aux capacités de votre modèle. Transmettez l’identifiant exact du modèle actif ; ne le raccourcissez pas en alias de famille.

​
Remarques

  • Parallel classe et compresse les résultats pour faciliter le raisonnement des LLM, et non pour favoriser les clics humains ; attendez-vous à des extraits denses pour chaque résultat plutôt qu’au contenu de pages complètes.
  • Les extraits de résultats sont renvoyés sous forme de tableau excerpts et sont également concaténés dans description pour assurer la compatibilité avec le contrat générique web_search.
  • Les deux fournisseurs renvoient un session_id ; OpenClaw l’expose sous la forme sessionId dans la charge utile de l’outil afin que les appelants puissent regrouper les recherches suivantes. Un identifiant de session généré par Parallel, c’est-à-dire non fourni par l’appelant, est exclu de l’entrée de cache, car des tâches sans rapport utilisant des requêtes identiques ne doivent pas en hériter.
  • Les valeurs searchId, warnings et usage de Parallel sont transmises lorsqu’elles sont présentes.
  • OpenClaw transmet toujours à Parallel un nombre de résultats résolu sous la forme advanced_settings.max_results (parallel) ou applique count côté client après la réponse de taille fixe de Parallel (parallel-free). L’argument count de l’appelant est prioritaire, suivi de tools.web.search.maxResults, puis de la valeur par défaut générique de web_search d’OpenClaw (5) ; la valeur par défaut de l’API de Parallel est 10.
  • Les résultats sont mis en cache pendant 15 minutes par défaut (cacheTtlMinutes).
  • parallel-free crée un nouveau session_id à chaque appel lors de sa négociation MCP si l’appelant n’en fournit pas ; parallel le laisse non défini dans ce cas.

​
Voir aussi