Skip to main content
يوفر Plugin ‏Parallel موفّري web_search من Parallel، ويعيد كلاهما مقتطفات مرتبة ومحسّنة لنماذج LLM من فهرس ويب مُنشأ لوكلاء الذكاء الاصطناعي: اضبط tools.web.search.provider على parallel-free أو parallel لاختيار أحدهما صراحةً؛ فلا يُكتشف أيٌّ منهما تلقائيًا.
تستخدم نماذج OpenAI Responses المباشرة (api: "openai-responses"، والموفّر openai، وعنوان URL الأساسي الرسمي لواجهة API) بحث الويب الأصلي المستضاف من OpenAI تلقائيًا عندما تكون tools.web.search.provider غير مضبوطة أو فارغة أو تساوي "auto" أو "openai" — ولذلك تتجاوز Parallel افتراضيًا. اضبط tools.web.search.provider على parallel-free أو parallel لتوجيهها عبر Parallel بدلًا من ذلك. راجع نظرة عامة على بحث الويب.

​
تثبيت Plugin

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

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

إنشاء حساب

سجّل في platform.parallel.ai وأنشئ مفتاح API من لوحة معلوماتك.
2

تخزين المفتاح

اضبط PARALLEL_API_KEY في بيئة Gateway، أو هيّئه عبر:

​
الإعداد

بديل عبر البيئة: اضبط 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 للحصول على أفضل النتائج.
​
string
مطلوب
وصف بلغة طبيعية للسؤال أو الهدف الأساسي (بحد أقصى 5000 محرف). ينبغي أن يكون مكتفيًا بذاته.
​
string[]
مطلوب
استعلامات بحث موجزة بكلمات مفتاحية، يتكوّن كل منها من 3 إلى 6 كلمات (من 1 إلى 5 إدخالات، وبحد أقصى 200 محرف لكل إدخال). قدّم استعلامين أو ثلاثة استعلامات متنوعة للحصول على أفضل النتائج.
​
number
عدد النتائج المطلوب إرجاعها (من 1 إلى 40).
​
string
معرّف جلسة Parallel اختياري من sessionId لنتيجة سابقة. مرّره في عمليات البحث اللاحقة ضمن المهمة نفسها كي تجمع Parallel الاستدعاءات المرتبطة وتحسّن النتائج اللاحقة. الحد الأقصى 1000 محرف مع parallel، بينما تحدّه خدمة Search MCP المجانية parallel-free عند 100 محرف. يُحذف المعرّف الذي يتجاوز الحد (في المدفوع)، أو يُنشأ معرّف جديد (في المجاني).
​
string
معرّف اختياري للنموذج الذي يجري الاستدعاء (مثل claude-opus-4-7 أو gpt-5.6-sol)، بحد أقصى 100 محرف. يتيح ذلك لـ 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 غير مضبوطة في هذه الحالة.

​
ذو صلة