---
read_when:
- Je wilt op internet zoeken zonder API-sleutel
- Je wilt de betaalde Search API van Parallel gebruiken
- Je wilt compacte fragmenten die zijn gerangschikt op efficiëntie voor LLM-context
summary: Parallel zoeken -- voor LLM geoptimaliseerde compacte fragmenten uit webbronnen
title: Parallel zoeken
x-i18n:
generated_at: "2026-07-12T09:30:24Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: eff693f286015b287bbdacf44f11ff6f07f2f7d2605ef6f09259e7402b40515e
source_path: tools/parallel-search.md
workflow: 16
---
De Parallel-plugin biedt twee `web_search`-providers van [Parallel](https://parallel.ai/), die beide gerangschikte, voor LLM's geoptimaliseerde fragmenten retourneren uit een webindex die voor AI-agents is gebouwd:
| Provider | id | Authenticatie |
| ------------------------ | --------------- | ----------------------------------------------------------------------------------------------------- |
| Parallel Search (gratis) | `parallel-free` | Geen -- de gratis [Search MCP](https://docs.parallel.ai/integrations/mcp/search-mcp) van Parallel |
| Parallel Search | `parallel` | `PARALLEL_API_KEY` -- betaalde Search API, hogere limieten en afstemming op doelstellingen |
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 de gehoste native
webzoekfunctie van OpenAI wanneer `tools.web.search.provider` niet is ingesteld,
leeg is, `"auto"` is 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 zoeken op het web](/nl/tools/web).
## Plugin installeren
```bash
openclaw plugins install @openclaw/parallel-plugin
openclaw gateway restart
```
## 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:
Registreer je bij [platform.parallel.ai](https://platform.parallel.ai) en
genereer een API-sleutel via je dashboard.
Stel `PARALLEL_API_KEY` in de Gateway-omgeving in, of configureer deze via:
```bash
openclaw configure --section web
```
## Configuratie
```json5
{
plugins: {
entries: {
parallel: {
config: {
webSearch: {
apiKey: "par-...", // optioneel als PARALLEL_API_KEY is ingesteld
baseUrl: "https://api.parallel.ai", // optioneel; OpenClaw voegt /v1/search toe
},
},
},
},
},
tools: {
web: {
search: {
// "parallel-free" voor de gratis Search MCP, of "parallel" voor de
// hier getoonde betaalde provider op basis van de API.
provider: "parallel",
},
},
},
}
```
**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
Dit 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
aanvragen via een compatibele proxy of een alternatief eindpunt te routeren
(bijvoorbeeld de Cloudflare AI Gateway). OpenClaw normaliseert losse hostnamen
door `https://` ervoor te plaatsen en voegt `/v1/search` toe, tenzij het pad
daar al mee eindigt. Het opgeloste eindpunt maakt deel uit van de
zoekcachecode, 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](https://docs.parallel.ai/search/best-practices)
voor de beste resultaten.
Beschrijving in natuurlijke taal van de onderliggende vraag of het doel
(maximaal 5000 tekens). Moet op zichzelf staan.
Beknopte zoekopdrachten met trefwoorden, elk 3-6 woorden (1-5 items, maximaal
200 tekens per item). Geef 2-3 uiteenlopende zoekopdrachten op voor de beste
resultaten.
Aantal te retourneren resultaten (1-40).
Optionele Parallel-sessie-id uit de `sessionId` van een eerder resultaat. Geef
deze door bij vervolgzoekopdrachten binnen dezelfde taak, zodat Parallel
gerelateerde aanroepen groepeert en latere resultaten verbetert. Maximaal 1000
tekens bij `parallel`; de gratis Search MCP `parallel-free` beperkt deze tot
100. Een id die de limiet overschrijdt, wordt verwijderd (betaald) of vervangen
door een nieuw gegenereerde id (gratis).
Optionele identificatie van het model dat de aanroep uitvoert (bijvoorbeeld
`claude-opus-4-7`, `gpt-5.6-sol`), maximaal 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 alias voor
de modelfamilie.
## Opmerkingen
- Parallel rangschikt en comprimeert resultaten op bruikbaarheid voor
LLM-redeneringen, niet voor doorklikken door mensen; verwacht per resultaat
compacte, informatierijke fragmenten in plaats van volledige pagina-inhoud.
- Resultaatfragmenten worden geretourneerd als de array `excerpts` en worden
ook samengevoegd tot `description` voor compatibiliteit met het algemene
`web_search`-contract.
- Beide providers retourneren een `session_id`; OpenClaw stelt 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 het cache-item, omdat niet-gerelateerde
taken met identieke zoekopdrachten deze niet mogen overnemen.
- `searchId`, `warnings` en `usage` van Parallel worden 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
clientzijde toe na het antwoord met vaste grootte van Parallel
(`parallel-free`). Het argument `count` van de aanroeper heeft voorrang,
gevolgd door `tools.web.search.maxResults`; anders wordt de algemene
standaardwaarde (5) van OpenClaws `web_search` gebruikt -- de eigen
standaardwaarde van de Parallel-API is 10.
- Resultaten worden standaard 15 minuten in de cache opgeslagen
(`cacheTtlMinutes`).
- `parallel-free` genereert per aanroep via de MCP-handshake een nieuwe
`session_id` wanneer de aanroeper er geen opgeeft; `parallel` laat deze in
dat geval leeg.
## Gerelateerd
- [Overzicht van zoeken op het web](/nl/tools/web) -- alle providers en automatische detectie
- [Zoeken met Exa](/nl/tools/exa-search) -- neuraal zoeken met inhoudsextractie
- [Zoeken met Perplexity](/nl/tools/perplexity-search) -- gestructureerde resultaten met domeinfiltering