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

Tools

Búsqueda paralela

El plugin Parallel proporciona dos proveedores de Parallel web_search, ambos devuelven fragmentos clasificados y optimizados para LLM de un índice web creado para agentes de IA:

Proveedor id Autenticación
Parallel Search (gratuito) parallel-free Ninguna: Search MCP gratuito de Parallel
Parallel Search parallel PARALLEL_API_KEY: API de búsqueda de pago, límites de frecuencia más altos y ajuste de objetivos

Establezca tools.web.search.provider en parallel-free o parallel para seleccionar uno explícitamente; ninguno se detecta automáticamente.

Instalar el plugin

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

Clave de API (proveedor de pago)

parallel-free no necesita ninguna clave, pero aun así debe seleccionarse explícitamente. El proveedor de pago parallel necesita una clave de API:

  • Crear una cuenta

    Regístrese en platform.parallel.ai y genere una clave de API desde su panel.

  • Almacenar la clave

    Establezca PARALLEL_API_KEY en el entorno del Gateway o configúrela mediante:

    bash
    openclaw configure --section web

    • Configuración

    json5
    {  plugins: {    entries: {      parallel: {        config: {          webSearch: {            apiKey: "par-...", // opcional si PARALLEL_API_KEY está definido            baseUrl: "https://api.parallel.ai", // opcional; OpenClaw añade /v1/search          },        },      },    },  },  tools: {    web: {      search: {        // "parallel-free" para el Search MCP gratuito o "parallel" para el        // proveedor de pago respaldado por API que se muestra aquí.        provider: "parallel",      },    },  },}

    Alternativa mediante variable de entorno: establezca PARALLEL_API_KEY en el entorno del Gateway. Para una instalación del Gateway, colóquela en ~/.openclaw/.env.

    Sustitución de la URL base

    Se aplica solo al proveedor de pago parallel; parallel-free siempre utiliza https://search.parallel.ai/mcp e ignora esta configuración.

    Establezca plugins.entries.parallel.config.webSearch.baseUrl para dirigir las solicitudes de pago a través de un proxy compatible o un punto de conexión alternativo (por ejemplo, Cloudflare AI Gateway). OpenClaw normaliza los hosts sin esquema anteponiendo https:// y añade /v1/search a menos que la ruta ya termine así. El punto de conexión resuelto forma parte de la clave de caché de búsqueda, por lo que nunca se comparten resultados de puntos de conexión diferentes.

    Parámetros de la herramienta

    Ambos proveedores exponen la estructura de búsqueda nativa de Parallel para que el modelo complete un objetivo en lenguaje natural junto con unas pocas consultas breves por palabras clave: la combinación que Parallel recomienda para obtener los mejores resultados.

    objectivestringrequired

    Descripción en lenguaje natural de la pregunta o el objetivo subyacente (máximo de 5000 caracteres). Debe ser autosuficiente.

    search_queriesstring[]required

    Consultas de búsqueda concisas por palabras clave, de 3 a 6 palabras cada una (de 1 a 5 entradas, máximo de 200 caracteres cada una). Proporcione de 2 a 3 consultas diversas para obtener los mejores resultados.

    countnumber

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

    session_idstring

    Identificador opcional de sesión de Parallel procedente de sessionId de un resultado anterior. Páselo en las búsquedas posteriores de la misma tarea para que Parallel agrupe las llamadas relacionadas y mejore los resultados posteriores. Máximo de 1000 caracteres en parallel; el Search MCP gratuito parallel-free lo limita a 100. Un identificador que supere el límite se descarta (en la versión de pago) o se genera uno nuevo (en la gratuita).

    client_modelstring

    Identificador opcional del modelo que realiza la llamada (p. ej., claude-opus-4-7, gpt-5.6-sol), con un máximo de 100 caracteres. Permite que Parallel adapte la configuración predeterminada a las capacidades del modelo. Pase el identificador exacto del modelo activo; no lo acorte a un alias de familia.

    Notas

    • Parallel clasifica y comprime los resultados según su utilidad para el razonamiento de los LLM, no para que las personas accedan a ellos mediante clics; se deben esperar fragmentos densos por resultado en lugar del contenido de la página completa.
    • Los fragmentos de resultados se devuelven como la matriz excerpts y también se concatenan en description para mantener la compatibilidad con el contrato genérico web_search.
    • Ambos proveedores devuelven un session_id; OpenClaw lo expone como sessionId en la carga útil de la herramienta para que los llamadores puedan agrupar las búsquedas posteriores. Un identificador de sesión generado por Parallel (uno que el llamador no haya proporcionado) se excluye de la entrada de caché, ya que las tareas no relacionadas con consultas idénticas no deben heredarlo.
    • searchId, warnings y usage de Parallel se transfieren cuando están presentes.
    • OpenClaw siempre reenvía a Parallel un recuento de resultados resuelto como advanced_settings.max_results (parallel) o aplica count en el lado del cliente después de la respuesta de tamaño fijo de Parallel (parallel-free). El argumento count del llamador tiene prioridad, seguido de tools.web.search.maxResults; de lo contrario, se utiliza el valor predeterminado genérico web_search de OpenClaw (5); la API de Parallel utiliza 10 de forma predeterminada.
    • Los resultados se almacenan en caché durante 15 minutos de forma predeterminada (cacheTtlMinutes).
    • parallel-free genera un session_id nuevo en cada llamada mediante su protocolo de enlace MCP cuando el llamador no proporciona uno; parallel lo deja sin definir en ese caso.

    Relacionado

    Was this useful?
    On this page

    On this page