Tools

Parallel zoeken

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:

Provider id Authenticatie
Parallel Search (gratis) parallel-free Geen -- Parallels gratis Search MCP
Parallel Search parallel PARALLEL_API_KEY -- betaalde Search API, hogere frequentielimieten 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

    Meld je aan bij platform.parallel.ai en genereer een API-sleutel vanuit 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 met API-backend.        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

    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.

    objectivestringrequired

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

    search_queriesstring[]required

    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.

    countnumber

    Aantal te retourneren resultaten (1-40).

    session_idstring

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

    client_modelstring

    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

    Was this useful?
    On this page

    On this page