Passer au contenu principal
Le Plugin Parallel fournit deux fournisseurs web_search Parallel :
  • Parallel Search (Free) (parallel-free) — le Search MCP gratuit de Parallel. Ne nécessite aucun compte ni clé API. Sélectionnez-le explicitement lorsque vous voulez utiliser le chemin de recherche hébergé de Parallel sans clé.
  • Parallel Search (parallel) — l’API de recherche payante de Parallel. Nécessite une PARALLEL_API_KEY et offre des limites de débit plus élevées ainsi qu’un réglage des objectifs.
Les deux renvoient des extraits classés et optimisés pour les LLM à partir d’un index web conçu pour les agents IA. Définissez tools.web.search.provider sur parallel-free ou parallel pour en choisir un explicitement.
Les modèles OpenAI Responses utilisent la recherche web native d’OpenAI lorsque tools.web.search.provider n’est pas défini, ils contournent donc les fournisseurs Parallel. Définissez tools.web.search.provider sur parallel-free ou parallel pour les router via Parallel.

​
Installer le Plugin

Installez le Plugin officiel, puis redémarrez Gateway : 
openclaw plugins install @openclaw/parallel-plugin
openclaw gateway restart

​
Clé API (fournisseur payant)

parallel-free ne nécessite aucune clé API, mais il doit tout de même être sélectionné comme fournisseur géré. Le fournisseur payant parallel a besoin d’une clé API :
1

Create an account

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

Store the key

Définissez PARALLEL_API_KEY dans l’environnement Gateway, ou configurez-la via :
openclaw configure --section web

​
Configuration

{
  plugins: {
    entries: {
      parallel: {
        config: {
          webSearch: {
            apiKey: "par-...", // optional if PARALLEL_API_KEY is set
            baseUrl: "https://api.parallel.ai", // optional; OpenClaw appends /v1/search
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        // Use "parallel-free" for the free Search MCP, or "parallel" for
        // the paid API-backed provider shown here.
        provider: "parallel",
      },
    },
  },
}
Autre option d’environnement : définissez PARALLEL_API_KEY dans l’environnement Gateway. Pour une installation gateway, placez-la dans ~/.openclaw/.env.

​
Remplacement de l’URL de base

Le remplacement de l’URL de base s’applique uniquement au fournisseur payant parallel. Le fournisseur gratuit parallel-free utilise toujours https://search.parallel.ai/mcp. Définissez plugins.entries.parallel.config.webSearch.baseUrl lorsque les requêtes Parallel doivent passer par un proxy compatible ou un autre point de terminaison Parallel (par exemple, le Cloudflare AI Gateway). OpenClaw normalise les hôtes nus en ajoutant https:// au début et ajoute /v1/search, sauf si le chemin se termine déjà ainsi. Le point de terminaison résolu est inclus dans la clé de cache de recherche, de sorte que les résultats provenant de différents points de terminaison Parallel ne sont pas partagés.

​
Paramètres de l’outil

OpenClaw expose la forme de recherche native de Parallel afin que le modèle puisse renseigner à la fois l’objectif en langage naturel et quelques courtes requêtes par mots-clés — l’association que Parallel recommande pour obtenir les meilleurs résultats.
​
objective
string
requis
Description en langage naturel de la question ou de l’objectif sous-jacent (5 000 caractères maximum). Doit être autonome.
​
search_queries
string[]
requis
Requêtes de recherche concises par mots-clés, 3 à 6 mots chacune (1 à 5 entrées, 200 caractères maximum chacune). Fournissez 2 à 3 requêtes diverses pour de meilleurs résultats.
​
count
number
Résultats à renvoyer (1 à 40).
​
session_id
string
Identifiant de session Parallel facultatif (1 000 caractères maximum sur parallel ; le Search MCP gratuit parallel-free le limite à 100). Transmettez le sessionId d’un résultat Parallel précédent lors des recherches de suivi faisant partie de la même tâche afin que Parallel puisse regrouper les appels associés et améliorer les résultats suivants. Un identifiant qui dépasse la limite est abandonné et un nouveau est généré.
​
client_model
string
Identifiant facultatif du modèle effectuant l’appel (par exemple claude-opus-4-7, gpt-5.5). Permet à Parallel d’adapter les paramètres par défaut aux capacités de votre modèle. Transmettez le slug exact du modèle actif ; ne le raccourcissez pas en alias de famille.

​
Notes

  • Parallel classe et compresse les résultats selon leur utilité pour le raisonnement LLM, et non selon le taux de clic humain ; attendez-vous à des extraits denses dans chaque résultat plutôt qu’à du contenu de page complet
  • Les extraits de résultats reviennent sous forme de tableau excerpts et sont également joints dans le champ description pour compatibilité avec le contrat générique web_search
  • Parallel renvoie un session_id dans chaque réponse ; OpenClaw l’expose sous forme de sessionId dans la charge utile de l’outil afin que les appelants puissent regrouper les recherches de suivi
  • searchId, warnings et usage de Parallel sont transmis lorsqu’ils sont présents
  • OpenClaw transmet toujours un nombre de résultats résolu à Parallel sous advanced_settings.max_results. L’argument count de l’appelant prévaut, puis le paramètre de premier niveau tools.web.search.maxResults, sinon la valeur par défaut générique web_search d’OpenClaw (5). Cela maintient un volume de résultats cohérent lors du passage d’un fournisseur à l’autre ; Parallel utilise par défaut 10 de son côté
  • Les résultats sont mis en cache pendant 15 minutes par défaut (configurable via cacheTtlMinutes)
  • Le fournisseur gratuit parallel-free accepte les mêmes paramètres. Il applique count côté client et génère un session_id par appel lorsqu’aucun n’est fourni.

​
Associés