البحث المتوازي

يوفر Plugin ‏Parallel موفّري web_search من Parallel، ويعيد كلاهما مقتطفات مرتبة ومحسّنة لنماذج LLM من فهرس ويب مُنشأ لوكلاء الذكاء الاصطناعي:

اضبط tools.web.search.provider على parallel-free أو parallel لاختيار أحدهما صراحةً؛ فلا يُكتشف أيٌّ منهما تلقائيًا.

تثبيت Plugin

openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

مفتاح API (الموفّر المدفوع)

لا يحتاج parallel-free إلى مفتاح، لكن يجب مع ذلك اختياره صراحةً. يحتاج موفّر parallel المدفوع إلى مفتاح API:

openclaw configure --section web

الإعداد

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

تجاوز عنوان URL الأساسي

ينطبق على موفّر parallel المدفوع فقط؛ يستخدم parallel-free دائمًا https://search.parallel.ai/mcp ويتجاهل هذا الإعداد.

اضبط plugins.entries.parallel.config.webSearch.baseUrl لتوجيه الطلبات المدفوعة عبر وكيل متوافق أو نقطة نهاية بديلة (مثل Cloudflare AI Gateway). يطبّع OpenClaw أسماء المضيفين المجرّدة بإضافة https:// في بدايتها، ويضيف /v1/search ما لم يكن المسار ينتهي به بالفعل. تُعدّ نقطة النهاية المحسوبة جزءًا من مفتاح ذاكرة التخزين المؤقت للبحث، لذلك لا تُشارك أبدًا النتائج الواردة من نقاط نهاية مختلفة.

معاملات الأداة

يعرض كلا الموفّرين بنية البحث الأصلية في Parallel كي يملأ النموذج هدفًا بلغة طبيعية مع بضعة استعلامات قصيرة بكلمات مفتاحية -- وهي التركيبة التي توصي بها Parallel للحصول على أفضل النتائج.

ملاحظات

• ترتّب Parallel النتائج وتضغطها لتفيد استدلال نماذج LLM، لا لينقر عليها البشر؛ لذا توقّع مقتطفات كثيفة لكل نتيجة بدلًا من محتوى الصفحة الكامل.
• تعود مقتطفات النتائج ضمن مصفوفة excerpts، كما تُدمج في description للتوافق مع عقد web_search العام.
• يعيد كلا الموفّرين session_id؛ ويعرضه OpenClaw باسم sessionId في حمولة الأداة كي يتمكن المستدعون من تجميع عمليات البحث اللاحقة. يُستبعد معرّف الجلسة الذي أنشأته Parallel (أي الذي لم يقدمه المستدعي) من إدخال ذاكرة التخزين المؤقت، حتى لا ترثه مهام غير مرتبطة ذات استعلامات متطابقة.
• تُمرّر قيم searchId وwarnings وusage الواردة من Parallel عند وجودها.
• يمرّر OpenClaw دائمًا عدد النتائج المحسوب إلى Parallel باسم advanced_settings.max_results مع (parallel)، أو يطبّق count من جهة العميل بعد استجابة Parallel ذات الحجم الثابت مع (parallel-free). تتقدّم وسيطة count الخاصة بالمستدعي، ثم tools.web.search.maxResults، وإلا تُستخدم القيمة الافتراضية العامة لـ web_search في OpenClaw وهي (5) -- بينما القيمة الافتراضية لواجهة API الخاصة بـ Parallel هي 10.
• تُخزّن النتائج مؤقتًا لمدة 15 دقيقة افتراضيًا (cacheTtlMinutes).
• ينشئ parallel-free قيمة session_id جديدة لكل استدعاء عبر مصافحة MCP عندما لا يقدّم المستدعي واحدة؛ بينما يتركها parallel غير مضبوطة في هذه الحالة.

ذو صلة

• نظرة عامة على بحث الويب -- جميع الموفّرين والاكتشاف التلقائي
• بحث Exa -- بحث عصبي مع استخراج المحتوى
• بحث Perplexity -- نتائج منظّمة مع تصفية حسب النطاق