Skip to main content
De Parallel-Plugin biedt twee Parallel web_search providers, die beide gerangschikte, voor LLM’s geoptimaliseerde fragmenten retourneren uit een webindex die voor AI-agents is gebouwd: Stel tools.web.search.provider in op parallel-free of parallel om er expliciet één te selecteren; geen van beide wordt automatisch gedetecteerd.
Directe OpenAI Responses-modellen (api: "openai-responses", provider openai, officiële API-basis-URL) gebruiken automatisch OpenAI’s gehoste native webzoekfunctie wanneer tools.web.search.provider niet is ingesteld, leeg is, "auto" of "openai" is — standaard omzeilen ze Parallel dus. Stel tools.web.search.provider in op parallel-free of parallel om ze in plaats daarvan via Parallel te routeren. Zie Overzicht van webzoeken.

​
Plugin installeren

​
API-sleutel (betaalde provider)

parallel-free heeft geen sleutel nodig, maar moet nog steeds expliciet worden geselecteerd. De betaalde provider parallel heeft een API-sleutel nodig:
1

Een account aanmaken

Meld je aan bij platform.parallel.ai en genereer een API-sleutel vanuit je dashboard.
2

De sleutel opslaan

Stel PARALLEL_API_KEY in de Gateway-omgeving in, of configureer deze via:

​
Configuratie

Alternatief via de omgeving: stel PARALLEL_API_KEY in de Gateway- omgeving in. Plaats deze voor een Gateway-installatie in ~/.openclaw/.env.

​
Basis-URL overschrijven

Geldt alleen voor de betaalde provider parallel; parallel-free gebruikt altijd https://search.parallel.ai/mcp en negeert deze instelling. Stel plugins.entries.parallel.config.webSearch.baseUrl in om betaalde verzoeken via een compatibele proxy of alternatief eindpunt te routeren (bijvoorbeeld de Cloudflare AI Gateway). OpenClaw normaliseert kale hosts door https:// ervoor te plaatsen en voegt /v1/search toe, tenzij het pad daar al op eindigt. Het opgeloste eindpunt maakt deel uit van de cachecode voor zoekopdrachten, zodat resultaten van verschillende eindpunten nooit worden gedeeld.

​
Toolparameters

Beide providers bieden de native zoekstructuur van Parallel, zodat het model een doel in natuurlijke taal plus enkele korte trefwoordzoekopdrachten invult — de combinatie die Parallel aanbeveelt voor de beste resultaten.
​
string
vereist
Beschrijving in natuurlijke taal van de onderliggende vraag of het doel (max. 5000 tekens). Moet op zichzelf staan.
​
string[]
vereist
Beknopte zoekopdrachten met trefwoorden, elk 3-6 woorden (1-5 vermeldingen, max. 200 tekens per stuk). Geef voor de beste resultaten 2-3 gevarieerde zoekopdrachten op.
​
number
Aantal te retourneren resultaten (1-40).
​
string
Optionele Parallel-sessie-id uit sessionId van een eerder resultaat. Geef deze door bij vervolgzoekopdrachten binnen dezelfde taak, zodat Parallel gerelateerde aanroepen groepeert en volgende resultaten verbetert. Max. 1000 tekens voor parallel; de gratis parallel-free Search MCP beperkt dit tot 100. Een id die de limiet overschrijdt, wordt verwijderd (betaald) of er wordt een nieuwe aangemaakt (gratis).
​
string
Optionele identificatie van het model dat de aanroep uitvoert (bijv. claude-opus-4-7, gpt-5.6-sol), max. 100 tekens. Hiermee kan Parallel de standaardinstellingen afstemmen op de mogelijkheden van je model. Geef de exacte slug van het actieve model door; kort deze niet in tot een familiealias.

​
Opmerkingen

  • Parallel rangschikt en comprimeert resultaten voor gebruik bij redeneringen door LLM’s, niet voor doorklikken door mensen; verwacht compacte fragmenten per resultaat in plaats van volledige pagina-inhoud.
  • Resultaatfragmenten worden geretourneerd als de array excerpts en worden ook samengevoegd in description voor compatibiliteit met het algemene contract web_search.
  • Beide providers retourneren een session_id; OpenClaw maakt deze als sessionId beschikbaar in de toolpayload, zodat aanroepers vervolgzoekopdrachten kunnen groeperen. Een door Parallel gegenereerde sessie-id (die niet door de aanroeper is opgegeven) wordt uitgesloten van de cachevermelding, omdat niet-gerelateerde taken met identieke zoekopdrachten deze niet mogen overnemen.
  • searchId, warnings en usage van Parallel worden ongewijzigd doorgegeven wanneer ze aanwezig zijn.
  • OpenClaw stuurt altijd een vastgesteld aantal resultaten door naar Parallel als advanced_settings.max_results (parallel) of past count aan de clientzijde toe na Parallels respons met vaste grootte (parallel-free). Het argument count van de aanroeper heeft voorrang, daarna tools.web.search.maxResults, en anders geldt OpenClaws algemene standaardwaarde web_search (5) — de eigen API van Parallel gebruikt standaard 10.
  • Resultaten worden standaard 15 minuten in de cache opgeslagen (cacheTtlMinutes).
  • parallel-free maakt per aanroep via de MCP-handshake een nieuwe session_id aan wanneer de aanroeper er geen opgeeft; parallel laat deze in dat geval oningesteld.

​
Gerelateerd