Skip to main content
يسجّل Plugin ‏Perplexity موفّر web_search بوسيلتي نقل: واجهة Perplexity Search API الأصلية (نتائج منظّمة مع عوامل تصفية)، وإكمالات محادثة Perplexity Sonar، مباشرة أو عبر OpenRouter (إجابات مولّدة بالذكاء الاصطناعي مع استشهادات).
تتناول هذه الصفحة إعداد موفّر Perplexity. لمعرفة أداة Perplexity (كيفية استخدام الوكيل لها)، راجع بحث Perplexity.

​
تثبيت Plugin

​
بدء الاستخدام

1

تعيين مفتاح API

أو عيّن المفتاح مباشرةً:
يعمل أيضًا المفتاح المصدَّر باسم PERPLEXITY_API_KEY أو OPENROUTER_API_KEY في بيئة Gateway.
2

بدء البحث

يكتشف web_search ‏Perplexity تلقائيًا بمجرد أن يصبح مفتاحه بيانات اعتماد البحث المتاحة؛ ولا يلزم أي إعداد إضافي. لتثبيت الموفّر صراحةً:

​
أوضاع البحث

يحدّد Plugin وسيلة النقل بهذا الترتيب:
  1. عند تعيين webSearch.baseUrl أو webSearch.model: يوجّه الطلبات دائمًا عبر إكمالات محادثة Sonar إلى نقطة النهاية تلك، بصرف النظر عن نوع المفتاح.
  2. خلاف ذلك، يحدّد مصدر المفتاح نقطة النهاية: تختار بادئة المفتاح المضبوط وسيلة النقل (يتقدّم الإعداد على متغيرات البيئة)؛ ويستخدم مفتاح البيئة نقطة النهاية المطابقة له مباشرةً.
يستخدم المفتاح المضبوط ذو أي بادئة أخرى واجهة Search API الأصلية أيضًا. يستخدم مسار إكمالات المحادثة نموذج perplexity/sonar-pro افتراضيًا؛ ويمكن تجاوزه باستخدام plugins.entries.perplexity.config.webSearch.model.

​
التصفية في واجهة API الأصلية

تعيد عوامل التصفية الخاصة بالواجهة الأصلية خطأً وصفيًا عند استخدامها في مسار إكمالات المحادثة. لا يمكن الجمع بين freshness وdate_after/date_before.

​
الإعداد المتقدم

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

​
ذو صلة

أداة بحث Perplexity

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

مرجع الإعداد

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