web_search. وتُرجع نتائج منظَّمة تتضمن الحقول title وurl وsnippet.
لأغراض التوافق، يدعم OpenClaw أيضًا إعدادات Perplexity Sonar/OpenRouter القديمة. إذا استخدمت OPENROUTER_API_KEY، أو مفتاحًا يبدأ بـ sk-or-... في plugins.entries.perplexity.config.webSearch.apiKey، أو عيّنت plugins.entries.perplexity.config.webSearch.baseUrl / model، فسيتحول المزود إلى مسار إكمالات المحادثة ويُرجع إجابات مولَّدة بالذكاء الاصطناعي مع استشهادات بدلًا من نتائج Search API المنظَّمة.
تثبيت Plugin
ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway:الحصول على مفتاح Perplexity API
- أنشئ حساب Perplexity على perplexity.ai/settings/api.
- أنشئ مفتاح API في لوحة التحكم.
- خزّن المفتاح في الإعدادات أو عيّن
PERPLEXITY_API_KEYفي بيئة Gateway.
التوافق مع OpenRouter
إذا كنت تستخدم OpenRouter بالفعل مع Perplexity Sonar، فأبقِprovider: "perplexity" وعيّن OPENROUTER_API_KEY في بيئة Gateway، أو خزّن مفتاحًا يبدأ بـ sk-or-... في plugins.entries.perplexity.config.webSearch.apiKey.
عناصر التحكم الاختيارية في التوافق:
plugins.entries.perplexity.config.webSearch.baseUrlplugins.entries.perplexity.config.webSearch.model
أمثلة على الإعدادات
واجهة Perplexity Search API الأصلية
التوافق مع OpenRouter / Sonar
مكان تعيين المفتاح
عبر الإعدادات: شغّلopenclaw configure --section web. يؤدي ذلك إلى تخزين المفتاح في ~/.openclaw/openclaw.json ضمن plugins.entries.perplexity.config.webSearch.apiKey. يقبل هذا الحقل أيضًا كائنات SecretRef.
عبر البيئة: عيّن PERPLEXITY_API_KEY أو OPENROUTER_API_KEY في بيئة عملية Gateway. عند تثبيت Gateway، ضعه في ~/.openclaw/.env (أو في بيئة خدمتك). راجع متغيرات البيئة.
إذا كان provider: "perplexity" مهيّأً وتعذر حل SecretRef الخاص بمفتاح Perplexity من دون قيمة احتياطية من البيئة، فسيفشل بدء التشغيل/إعادة التحميل فورًا.
معاملات الأداة
تنطبق هذه المعاملات على مسار Perplexity Search API الأصلي.string
مطلوب
استعلام البحث.
number
افتراضي:"5"
عدد النتائج المطلوب إرجاعها (1-10).
string
رمز البلد وفق ISO والمكوّن من حرفين (مثل
US وDE).string
رمز اللغة وفق ISO 639-1 (مثل
en وde وfr).'day' | 'week' | 'month' | 'year'
مرشح زمني؛ تمثل
day مدة 24 ساعة.string
النتائج المنشورة بعد هذا التاريخ فقط (
YYYY-MM-DD).string
النتائج المنشورة قبل هذا التاريخ فقط (
YYYY-MM-DD).string[]
مصفوفة قائمة السماح/الحظر للنطاقات (بحد أقصى 20).
number
افتراضي:"25000"
إجمالي ميزانية المحتوى (بحد أقصى 1000000).
number
افتراضي:"2048"
حد الرموز لكل صفحة.
- تُقبل
queryوcountوfreshness. - تُستخدم
countلأغراض التوافق فقط في هذا المسار؛ إذ تظل الاستجابة إجابة واحدة مولَّدة مع استشهادات، وليست قائمة من N من النتائج. - تُرجع المرشحات الخاصة بواجهة Search API فقط (
countryوlanguageوdate_afterوdate_beforeوdomain_filterوmax_tokensوmax_tokens_per_page) أخطاء صريحة.
قواعد مرشح النطاقات
- الحد الأقصى 20 نطاقًا لكل مرشح.
- لا يمكن الجمع بين إدخالات قائمة السماح وقائمة الحظر في الطلب نفسه.
- استخدم السابقة
-لإدخالات قائمة الحظر (مثل["-reddit.com"]).
ملاحظات
- تُرجع Perplexity Search API نتائج بحث ويب منظَّمة (
titleوurlوsnippet). - يؤدي استخدام OpenRouter، أو تعيين
plugins.entries.perplexity.config.webSearch.baseUrl/modelصراحةً، إلى إعادة Perplexity إلى إكمالات محادثة Sonar لأغراض التوافق. - يُرجع التوافق مع Sonar/OpenRouter إجابة واحدة مولَّدة مع استشهادات، وليس صفوف نتائج منظَّمة.
- تُخزَّن النتائج مؤقتًا لمدة 15 دقيقة افتراضيًا (يمكن ضبطها عبر
cacheTtlMinutes).
موضوعات ذات صلة
نظرة عامة على بحث الويب
جميع المزودين وقواعد الاكتشاف التلقائي.
بحث Brave
نتائج منظَّمة مع مرشحات البلد واللغة.
بحث Exa
بحث عصبي مع استخراج المحتوى.
وثائق Perplexity Search API
دليل البدء السريع والمرجع الرسميان لواجهة Perplexity Search API.