الانتقال إلى المحتوى الرئيسي

​
Perplexity (مزوّد البحث على الويب)

يوفّر Plugin الخاص بـ Perplexity قدرات البحث على الويب من خلال Perplexity Search API أو Perplexity Sonar عبر OpenRouter.
تغطي هذه الصفحة إعداد المزوّد الخاص بـ Perplexity. أما الأداة الخاصة بـ Perplexity (كيفية استخدام الوكيل لها)، فراجع أداة Perplexity.
الخاصيةالقيمة
النوعمزوّد بحث على الويب (وليس مزوّد نماذج)
المصادقةPERPLEXITY_API_KEY ‏(مباشر) أو OPENROUTER_API_KEY ‏(عبر OpenRouter)
مسار الإعدادplugins.entries.perplexity.config.webSearch.apiKey

​
البدء

1

تعيين مفتاح API

شغّل مسار الإعداد التفاعلي للبحث على الويب:
openclaw configure --section web
أو اضبط المفتاح مباشرةً:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

بدء البحث

سيستخدم الوكيل Perplexity تلقائيًا لعمليات البحث على الويب بمجرد إعداد المفتاح. ولا يلزم اتخاذ أي خطوات إضافية.

​
أوضاع البحث

يختار Plugin النقل تلقائيًا استنادًا إلى بادئة مفتاح API:
عندما يبدأ المفتاح لديك بـ pplx-، يستخدم OpenClaw واجهة Perplexity Search API الأصلية. يعيد هذا النقل نتائج منظمة ويدعم عوامل تصفية النطاق واللغة والتاريخ (راجع خيارات التصفية أدناه).
بادئة المفتاحالنقلالميزات
pplx-Perplexity Search API الأصليةنتائج منظمة، وعوامل تصفية للنطاق/اللغة/التاريخ
sk-or-OpenRouter ‏(Sonar)إجابات مُركّبة بالذكاء الاصطناعي مع استشهادات

​
التصفية في API الأصلية

تتوفر خيارات التصفية فقط عند استخدام واجهة Perplexity API الأصلية (مفتاح pplx-). ولا تدعم عمليات بحث OpenRouter/Sonar هذه المعلمات.
عند استخدام واجهة Perplexity API الأصلية، تدعم عمليات البحث عوامل التصفية التالية:
عامل التصفيةالوصفالمثال
البلدرمز بلد مكوّن من حرفينus وde وjp
اللغةرمز لغة ISO 639-1en وfr وzh
النطاق الزمنينافذة الحداثة الزمنيةday وweek وmonth وyear
عوامل تصفية النطاققائمة سماح أو قائمة رفض (بحد أقصى 20 نطاقًا)example.com
ميزانية المحتوىحدود الرموز لكل استجابة / لكل صفحةmax_tokens وmax_tokens_per_page

​
ملاحظات متقدمة

إذا كان OpenClaw Gateway يعمل كخدمة daemon ‏(launchd/systemd)، فتأكد من أن PERPLEXITY_API_KEY متاح لتلك العملية.
المفتاح الذي يتم ضبطه فقط في ~/.profile لن يكون مرئيًا لخدمة daemon تعمل عبر launchd/systemd ما لم يتم استيراد تلك البيئة صراحةً. اضبط المفتاح في ~/.openclaw/.env أو عبر env.shellEnv لضمان أن تتمكن عملية gateway من قراءته.
إذا كنت تفضل توجيه عمليات بحث Perplexity عبر OpenRouter، فاضبط OPENROUTER_API_KEY ‏(بالبادئة sk-or-) بدلًا من مفتاح Perplexity أصلي. سيكتشف OpenClaw البادئة وينتقل إلى نقل Sonar تلقائيًا.
يكون نقل OpenRouter مفيدًا إذا كان لديك بالفعل حساب OpenRouter وتريد فوترة موحدة عبر عدة مزوّدين.

​
ذو صلة

أداة البحث Perplexity

كيفية استدعاء الوكيل لعمليات بحث Perplexity وتفسير النتائج.

مرجع الإعدادات

مرجع الإعدادات الكامل بما في ذلك إدخالات Plugin.