OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Parallel zoeken

De Parallel-plugin biedt twee web_search-providers van Parallel, 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 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.

Plugin installeren

bash
openclaw plugins install @openclaw/parallel-pluginopenclaw 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:

  • Een account aanmaken

    Registreer je bij platform.parallel.ai en genereer een API-sleutel via je dashboard.

  • De sleutel opslaan

    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 voor de beste resultaten.

    objectivestringrequired

    Beschrijving in natuurlijke taal van de onderliggende vraag of het doel (maximaal 5000 tekens). Moet op zichzelf staan.

    search_queriesstring[]required

    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.

    countnumber

    Aantal te retourneren resultaten (1-40).

    session_idstring

    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).

    client_modelstring

    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

    Was this useful?
    On this page

    On this page