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

​
تثبيت Plugin

ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway: 
openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

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

1

تعيين مفتاح واجهة برمجة التطبيقات

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

بدء البحث

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

​
أوضاع البحث

يختار Plugin وسيلة النقل تلقائيًا بناءً على بادئة مفتاح واجهة برمجة التطبيقات:
عندما يبدأ مفتاحك بـ 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 يعمل كعملية خادم خلفية (launchd/systemd)، فتأكد من أن PERPLEXITY_API_KEY متاح لتلك العملية.
لن يكون المفتاح الذي يُصدَّر فقط في صدفة تفاعلية مرئيًا لعملية خادم خلفية launchd/systemd ما لم تُستورد تلك البيئة صراحةً. عيّن المفتاح في ~/.openclaw/.env أو عبر env.shellEnv لضمان قدرة عملية gateway على قراءته.
إذا كنت تفضّل توجيه عمليات بحث Perplexity عبر OpenRouter، فعيّن OPENROUTER_API_KEY (بالبادئة sk-or-) بدلًا من مفتاح Perplexity أصلي. سيكتشف OpenClaw البادئة وينتقل إلى وسيلة نقل Sonar تلقائيًا.
تكون وسيلة نقل OpenRouter مفيدة إذا كان لديك حساب OpenRouter بالفعل وتريد فوترة موحّدة عبر عدة مزوّدين.

​
ذو صلة

أداة بحث Perplexity

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

مرجع التكوين

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