Naar hoofdinhoud gaan
De Parallel-Plugin biedt twee Parallel web_search-providers:
  • Parallel Search (Free) (parallel-free) — Parallels gratis Search MCP. Vereist geen account of API-sleutel. Selecteer deze expliciet wanneer je Parallels gehoste zoekpad zonder sleutel wilt gebruiken.
  • Parallel Search (parallel) — Parallels betaalde Search API. Vereist een PARALLEL_API_KEY en biedt hogere snelheidslimieten en afstemming op doelen.
Beide retourneren gerangschikte, voor LLM’s geoptimaliseerde fragmenten uit een webindex die is gebouwd voor AI-agents. Stel tools.web.search.provider in op parallel-free of parallel om er expliciet een te kiezen.
OpenAI Responses-modellen gebruiken OpenAI’s native webzoekfunctie wanneer tools.web.search.provider niet is ingesteld, dus ze omzeilen de Parallel-providers. Stel tools.web.search.provider in op parallel-free of parallel om ze via Parallel te routeren.

​
Plugin installeren

Installeer de officiële Plugin en herstart daarna Gateway: 
openclaw plugins install @openclaw/parallel-plugin
openclaw gateway restart

​
API-sleutel (betaalde provider)

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

Maak een account aan

Registreer je op platform.parallel.ai en genereer een API-sleutel vanuit je dashboard.
2

Sla de sleutel op

Stel PARALLEL_API_KEY in de Gateway-omgeving in, of configureer via:
openclaw configure --section web

​
Configuratie

{
  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",
      },
    },
  },
}
Omgevingsalternatief: stel PARALLEL_API_KEY in de Gateway-omgeving in. Voor een gateway-installatie plaats je deze in ~/.openclaw/.env.

​
Overschrijving van basis-URL

De overschrijving van de basis-URL geldt alleen voor de betaalde parallel-provider. De gratis parallel-free-provider gebruikt altijd https://search.parallel.ai/mcp. Stel plugins.entries.parallel.config.webSearch.baseUrl in wanneer Parallel-aanvragen via een compatibele proxy of een alternatief Parallel-eindpunt moeten lopen (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 wordt opgenomen in de zoekcache-sleutel, zodat resultaten van verschillende Parallel-eindpunten niet worden gedeeld.

​
Toolparameters

OpenClaw stelt Parallels native zoekvorm beschikbaar, zodat het model zowel het doel in natuurlijke taal als enkele korte trefwoordquery’s kan invullen — de combinatie die Parallel aanbeveelt voor de beste resultaten.
​
objective
string
vereist
Beschrijving in natuurlijke taal van de onderliggende vraag of het doel (max. 5000 tekens). Moet op zichzelf staan.
​
search_queries
string[]
vereist
Beknopte zoekquery’s met trefwoorden, elk 3-6 woorden (1-5 items, max. 200 tekens elk). Geef 2-3 diverse query’s op voor de beste resultaten.
​
count
number
Aantal te retourneren resultaten (1-40).
​
session_id
string
Optionele Parallel-sessie-id (max. 1000 tekens op parallel; de gratis parallel-free Search MCP beperkt dit tot 100). Geef de sessionId uit een vorig Parallel-resultaat door bij vervolgzoekopdrachten die deel uitmaken van dezelfde taak, zodat Parallel gerelateerde aanroepen kan groeperen en latere resultaten kan verbeteren. Een id boven de limiet wordt genegeerd en er wordt een nieuwe gegenereerd.
​
client_model
string
Optionele identifier van het model dat de aanroep doet (bijv. claude-opus-4-7, gpt-5.5). Hiermee kan Parallel standaardinstellingen afstemmen op de mogelijkheden van je model. Geef de exacte actieve model-slug door; verkort deze niet tot een familiealias.

​
Opmerkingen

  • Parallel rangschikt en comprimeert resultaten op basis van bruikbaarheid voor LLM-redeneren, niet op doorklikgedrag van mensen; verwacht compacte fragmenten in elk resultaat in plaats van volledige pagina-inhoud
  • Resultaatfragmenten komen terug als de array excerpts en worden ook samengevoegd in het veld description voor compatibiliteit met het generieke web_search-contract
  • Parallel retourneert bij elke respons een session_id; OpenClaw geeft deze door als sessionId in de toolpayload, zodat aanroepers vervolgzoekopdrachten kunnen groeperen
  • searchId, warnings en usage van Parallel worden doorgegeven wanneer aanwezig
  • OpenClaw stuurt altijd een opgelost resultaataantal naar Parallel door als advanced_settings.max_results. Het argument count van de aanroeper wint, daarna de bovenliggende instelling tools.web.search.maxResults, en anders de standaardwaarde van OpenClaws generieke web_search (5). Dit houdt het resultaatvolume consistent bij het wisselen tussen providers; Parallel gebruikt zelfstandig standaard 10
  • Resultaten worden standaard 15 minuten gecachet (configureerbaar via cacheTtlMinutes)
  • De gratis parallel-free-provider accepteert dezelfde parameters. Deze past count client-side toe en genereert per aanroep een session_id wanneer er geen is opgegeven.

​
Gerelateerd