Tools

جست‌وجوی موازی

Plugin مربوط به Parallel دو ارائه‌دهندهٔ web_search از Parallel فراهم می‌کند که هر دو گزیده‌های رتبه‌بندی‌شده و بهینه‌شده برای LLM را از یک نمایهٔ وب ساخته‌شده برای عامل‌های هوش مصنوعی برمی‌گردانند:

ارائه‌دهنده شناسه احراز هویت
جست‌وجوی Parallel (رایگان) parallel-free هیچ‌کدام -- Search MCP رایگان Parallel
جست‌وجوی Parallel parallel PARALLEL_API_KEY -- API جست‌وجوی پولی، محدودیت نرخ بالاتر و تنظیم هدف

برای انتخاب صریح یکی از آن‌ها، tools.web.search.provider را روی parallel-free یا parallel تنظیم کنید؛ هیچ‌کدام به‌طور خودکار شناسایی نمی‌شوند.

نصب Plugin

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

کلید API (ارائه‌دهندهٔ پولی)

parallel-free به کلید نیاز ندارد، اما همچنان باید به‌طور صریح انتخاب شود. ارائه‌دهندهٔ پولی parallel به یک کلید API نیاز دارد:

  • ایجاد حساب

    در platform.parallel.ai ثبت‌نام کنید و از داشبورد خود یک کلید API بسازید.

  • ذخیره‌سازی کلید

    PARALLEL_API_KEY را در محیط Gateway تنظیم کنید، یا از این طریق پیکربندی کنید:

    bash
    openclaw configure --section web
  • پیکربندی

    json5
    {  plugins: {    entries: {      parallel: {        config: {          webSearch: {            apiKey: "par-...", // در صورت تنظیم PARALLEL_API_KEY اختیاری است            baseUrl: "https://api.parallel.ai", // اختیاری؛ OpenClaw ‏/v1/search را می‌افزاید          },        },      },    },  },  tools: {    web: {      search: {        // ‏"parallel-free" برای Search MCP رایگان، یا "parallel" برای        // ارائه‌دهندهٔ متکی به API پولی که اینجا نشان داده شده است.        provider: "parallel",      },    },  },}

    جایگزین محیطی: PARALLEL_API_KEY را در محیط Gateway تنظیم کنید. برای نصب Gateway، آن را در ~/.openclaw/.env قرار دهید.

    بازنویسی نشانی پایه

    فقط برای ارائه‌دهندهٔ پولی parallel اعمال می‌شود؛ parallel-free همیشه از https://search.parallel.ai/mcp استفاده می‌کند و این تنظیم را نادیده می‌گیرد.

    برای هدایت درخواست‌های پولی از طریق یک پراکسی سازگار یا نقطهٔ پایانی جایگزین (برای مثال، Cloudflare AI Gateway)، plugins.entries.parallel.config.webSearch.baseUrl را تنظیم کنید. OpenClaw میزبان‌های فاقد طرح را با افزودن https:// در ابتدا عادی‌سازی می‌کند و /v1/search را می‌افزاید، مگر اینکه مسیر از قبل به آن ختم شود. نقطهٔ پایانی حل‌شده بخشی از کلید کش جست‌وجو است، بنابراین نتایج نقطه‌های پایانی مختلف هرگز به‌اشتراک گذاشته نمی‌شوند.

    پارامترهای ابزار

    هر دو ارائه‌دهنده ساختار بومی جست‌وجوی Parallel را ارائه می‌کنند تا مدل یک هدف به زبان طبیعی را همراه با چند پرس‌وجوی کلیدواژه‌ای کوتاه تکمیل کند؛ ترکیبی که Parallel برای دستیابی به بهترین نتایج توصیه می‌کند.

    objectivestringrequired

    شرحی به زبان طبیعی از پرسش یا هدف زیربنایی (حداکثر 5000 نویسه). باید خودبسنده باشد.

    search_queriesstring[]required

    پرس‌وجوهای جست‌وجوی کلیدواژه‌ای مختصر، هرکدام 3-6 واژه (1-5 ورودی، حداکثر 200 نویسه برای هرکدام). برای بهترین نتایج، 2-3 پرس‌وجوی متنوع ارائه کنید.

    countnumber

    تعداد نتایجی که باید برگردانده شوند (1-40).

    session_idstring

    شناسهٔ نشست اختیاری Parallel از sessionId نتیجهٔ قبلی. آن را در جست‌وجوهای پیگیری همان وظیفه ارسال کنید تا Parallel فراخوانی‌های مرتبط را گروه‌بندی و نتایج بعدی را بهبود دهد. حداکثر 1000 نویسه در parallel؛ Search MCP رایگان parallel-free آن را به 100 محدود می‌کند. شناسه‌ای فراتر از حد مجاز حذف می‌شود (پولی) یا یک شناسهٔ تازه ساخته می‌شود (رایگان).

    client_modelstring

    شناسهٔ اختیاری مدلی که فراخوانی را انجام می‌دهد (برای مثال claude-opus-4-7، gpt-5.6-sol)، حداکثر 100 نویسه. به Parallel امکان می‌دهد تنظیمات پیش‌فرض را برای قابلیت‌های مدل شما متناسب کند. نامک دقیق مدل فعال را ارسال کنید؛ آن را به نام مستعار خانواده کوتاه نکنید.

    نکات

    • Parallel نتایج را برای سودمندی در استدلال LLM رتبه‌بندی و فشرده می‌کند، نه برای کلیک‌کردن انسان؛ بنابراین به‌جای محتوای کامل صفحه، انتظار گزیده‌های متراکم برای هر نتیجه را داشته باشید.
    • گزیده‌های نتیجه به‌شکل آرایهٔ excerpts برمی‌گردند و برای سازگاری با قرارداد عمومی web_search، در description نیز به‌هم پیوسته می‌شوند.
    • هر دو ارائه‌دهنده یک session_id برمی‌گردانند؛ OpenClaw آن را در بار ابزار به‌شکل sessionId ارائه می‌کند تا فراخوان‌ها بتوانند جست‌وجوهای پیگیری را گروه‌بندی کنند. شناسهٔ نشستی که Parallel تولید کرده است (شناسه‌ای که فراخوان ارائه نکرده) از ورودی کش کنار گذاشته می‌شود، زیرا وظایف نامرتبط با پرس‌وجوهای یکسان نباید آن را به ارث ببرند.
    • searchId، warnings و usage از Parallel، در صورت وجود، بدون تغییر عبور داده می‌شوند.
    • OpenClaw همیشه تعداد نتیجهٔ حل‌شده را به‌صورت advanced_settings.max_results (parallel) به Parallel ارسال می‌کند یا پس از پاسخ با اندازهٔ ثابت Parallel، count را در سمت کارخواه اعمال می‌کند (parallel-free). ابتدا آرگومان count فراخوان، سپس tools.web.search.maxResults و در غیر این صورت مقدار پیش‌فرض عمومی web_search در OpenClaw (5) اولویت دارد؛ مقدار پیش‌فرض API خود Parallel برابر با 10 است.
    • نتایج به‌طور پیش‌فرض برای 15 دقیقه کش می‌شوند (cacheTtlMinutes).
    • parallel-free هنگامی که فراخوان شناسه‌ای ارائه نکند، در هر فراخوان از طریق دست‌دهی MCP خود یک session_id تازه می‌سازد؛ parallel در آن حالت آن را تنظیم‌نشده باقی می‌گذارد.

    مرتبط

    Was this useful?
    On this page

    On this page