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 web_search de Parallel, ambos con fragmentos clasificados y optimizados para LLM procedentes 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 superiores y ajuste de objetivos

Establece 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ístrate en platform.parallel.ai y genera una clave de API desde tu panel.

  • Guardar la clave

    Establece PARALLEL_API_KEY en el entorno del Gateway o configúrala mediante:

    bash
    openclaw configure --section web

    • Configuración

    json5
    {  plugins: {    entries: {      parallel: {        config: {          webSearch: {            apiKey: "par-...", // opcional si PARALLEL_API_KEY está definida            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 el entorno: establece PARALLEL_API_KEY en el entorno del Gateway. Para una instalación del Gateway, inclúyela en ~/.openclaw/.env.

    Sustitución de la URL base

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

    Establece plugins.entries.parallel.config.webSearch.baseUrl para dirigir las solicitudes de pago a través de un proxy compatible o un endpoint 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 endpoint resuelto forma parte de la clave de caché de búsqueda, por lo que los resultados de distintos endpoints nunca se comparten.

    Parámetros de la herramienta

    Ambos proveedores exponen la estructura de búsqueda nativa de Parallel para que el modelo introduzca 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, con un máximo de 200 caracteres cada una). Proporciona de 2 a 3 consultas diversas para obtener los mejores resultados.

    countnumber

    Número de resultados que se devolverán (1-40).

    session_idstring

    Identificador opcional de sesión de Parallel procedente del sessionId de un resultado anterior. Transmítelo 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. Los identificadores que superan el límite se descartan (de pago) o se genera uno nuevo (gratuito).

    client_modelstring

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

    Notas

    • Parallel clasifica y comprime los resultados para facilitar el razonamiento de los LLM, no para que las personas hagan clic en ellos; se esperan fragmentos densos por resultado en lugar del contenido completo de la página.
    • Los fragmentos de resultados se devuelven como el array excerpts y también se combinan en description para mantener la compatibilidad con el contrato genérico de 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 proporcionó) 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 transmiten cuando están presentes.
    • OpenClaw siempre envía a Parallel un número de resultados resuelto como advanced_settings.max_results (parallel) o aplica count en el 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 de web_search de OpenClaw (5). El valor predeterminado de la propia API de Parallel es 10.
    • Los resultados se almacenan en caché durante 15 minutos de forma predeterminada (cacheTtlMinutes).
    • parallel-free genera un session_id nuevo para cada llamada mediante su negociación MCP cuando el llamador no proporciona uno; parallel lo deja sin definir en ese caso.

    Contenido relacionado

    Was this useful?
    On this page

    On this page