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 الأصلي.استعلام البحث.
عدد النتائج المراد إرجاعها (1-10).
رمز بلد ISO من حرفين (مثل
US وDE).رمز لغة ISO 639-1 (مثل
en وde وfr).مرشح زمني -
day تعني 24 ساعة.النتائج المنشورة بعد هذا التاريخ فقط (
YYYY-MM-DD).النتائج المنشورة قبل هذا التاريخ فقط (
YYYY-MM-DD).مصفوفة قائمة سماح/حظر للنطاقات (الحد الأقصى 20).
إجمالي ميزانية المحتوى (الحد الأقصى 1000000).
حد الرموز لكل صفحة.
- يتم قبول
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.