Tools

Búsqueda paralela

El Plugin Parallel proporciona dos proveedores web_search de Parallel:

  • Búsqueda de Parallel (gratis) (parallel-free) -- el Search MCP gratuito de Parallel. No requiere cuenta ni clave de API. Selecciónalo explícitamente cuando quieras la ruta de búsqueda alojada de Parallel sin clave.
  • Búsqueda de Parallel (parallel) -- la API Search de pago de Parallel. Requiere una PARALLEL_API_KEY y ofrece límites de tasa más altos y ajuste de objetivos.

Ambos devuelven extractos clasificados y optimizados para LLM desde un índice web creado para agentes de IA. Define tools.web.search.provider como parallel-free o parallel para elegir uno explícitamente.

Instalar Plugin

Instala el Plugin oficial y luego reinicia Gateway:

bash
openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

Clave de API (proveedor de pago)

parallel-free no requiere clave de API, pero aun así debe seleccionarse como proveedor administrado. El proveedor de pago parallel necesita una clave de API:

  • Create an account

    Regístrate en platform.parallel.ai y genera una clave de API desde tu panel.

  • Store the key

    Define PARALLEL_API_KEY en el entorno de Gateway, o configúrala mediante:

    bash
    openclaw configure --section web
  • Configuración

    json5
    {  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",      },    },  },}

    Alternativa de entorno: define PARALLEL_API_KEY en el entorno de Gateway. Para una instalación de gateway, colócala en ~/.openclaw/.env.

    Anulación de URL base

    La anulación de URL base se aplica solo al proveedor de pago parallel. El proveedor gratuito parallel-free siempre usa https://search.parallel.ai/mcp.

    Define plugins.entries.parallel.config.webSearch.baseUrl cuando las solicitudes de Parallel deban pasar por un proxy compatible o un endpoint alternativo de Parallel (por ejemplo, Cloudflare AI Gateway). OpenClaw normaliza hosts simples anteponiendo https:// y agrega /v1/search salvo que la ruta ya termine ahí. El endpoint resuelto se incluye en la clave de caché de búsqueda, por lo que los resultados de distintos endpoints de Parallel no se comparten.

    Parámetros de la herramienta

    OpenClaw expone la forma de búsqueda nativa de Parallel para que el modelo pueda completar tanto el objetivo en lenguaje natural como algunas consultas breves de palabras clave — la combinación que Parallel recomienda para obtener mejores resultados.

    objectivestringrequired

    Descripción en lenguaje natural de la pregunta u objetivo subyacente (máx. 5000 caracteres). Debe ser autónoma.

    search_queriesstring[]required

    Consultas de búsqueda concisas con palabras clave, de 3 a 6 palabras cada una (1 a 5 entradas, máx. 200 caracteres cada una). Proporciona 2 o 3 consultas diversas para obtener mejores resultados.

    countnumber

    Resultados que se devolverán (1-40).

    session_idstring

    Id. de sesión opcional de Parallel (máx. 1000 caracteres en parallel; el Search MCP gratuito parallel-free lo limita a 100). Pasa el sessionId de un resultado anterior de Parallel en búsquedas de seguimiento que formen parte de la misma tarea para que Parallel pueda agrupar llamadas relacionadas y mejorar los resultados posteriores. Un id. que supere el límite se descarta y se genera uno nuevo.

    client_modelstring

    Identificador opcional del modelo que realiza la llamada (p. ej., claude-opus-4-7, gpt-5.5). Permite que Parallel ajuste la configuración predeterminada según las capacidades de tu modelo. Pasa el slug exacto del modelo activo; no lo acortes a un alias de familia.

    Notas

    • Parallel clasifica y comprime los resultados según su utilidad para el razonamiento de LLM, no según clics humanos; espera extractos densos en cada resultado en lugar de contenido de página completa
    • Los extractos de resultados vuelven como el arreglo excerpts y también se unen en el campo description por compatibilidad con el contrato genérico web_search
    • Parallel devuelve un session_id en cada respuesta; OpenClaw lo expone como sessionId en la carga útil de la herramienta para que los llamadores puedan agrupar búsquedas de seguimiento
    • searchId, warnings y usage de Parallel se pasan tal cual cuando están presentes
    • OpenClaw siempre reenvía a Parallel un conteo de resultados resuelto como advanced_settings.max_results. El argumento count del llamador tiene prioridad, luego la configuración de nivel superior tools.web.search.maxResults; de lo contrario, se usa el valor predeterminado genérico de OpenClaw para web_search (5). Esto mantiene constante el volumen de resultados al cambiar entre proveedores; Parallel por sí solo usa 10 de forma predeterminada
    • Los resultados se almacenan en caché durante 15 minutos de forma predeterminada (configurable mediante cacheTtlMinutes)
    • El proveedor gratuito parallel-free acepta los mismos parámetros. Aplica count del lado del cliente y genera un session_id por llamada cuando no se proporciona uno.

    Relacionado

    Was this useful?
    On this page

    On this page