Providers
Perplexity
يسجّل Plugin Perplexity موفّر web_search بوسيلتي نقل: واجهة Perplexity Search API الأصلية (نتائج منظّمة مع عوامل تصفية)، وإكمالات محادثة Perplexity Sonar، مباشرة أو عبر OpenRouter (إجابات مولّدة بالذكاء الاصطناعي مع استشهادات).
| الخاصية | القيمة |
|---|---|
| النوع | موفّر بحث ويب (وليس موفّر نماذج) |
| المصادقة | PERPLEXITY_API_KEY (أصلي) أو OPENROUTER_API_KEY (عبر OpenRouter) |
| مسار الإعداد | plugins.entries.perplexity.config.webSearch.apiKey |
| التجاوزات | plugins.entries.perplexity.config.webSearch.baseUrl / .model |
| الحصول على مفتاح | perplexity.ai/settings/api |
تثبيت Plugin
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restartبدء الاستخدام
تعيين مفتاح API
openclaw configure --section webأو عيّن المفتاح مباشرةً:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"يعمل أيضًا المفتاح المصدَّر باسم PERPLEXITY_API_KEY أو OPENROUTER_API_KEY في بيئة Gateway.
بدء البحث
يكتشف web_search Perplexity تلقائيًا بمجرد أن يصبح مفتاحه بيانات اعتماد البحث المتاحة؛ ولا يلزم أي إعداد إضافي. لتثبيت الموفّر صراحةً:
openclaw config set tools.web.search.provider perplexityأوضاع البحث
يحدّد Plugin وسيلة النقل بهذا الترتيب:
- عند تعيين
webSearch.baseUrlأوwebSearch.model: يوجّه الطلبات دائمًا عبر إكمالات محادثة Sonar إلى نقطة النهاية تلك، بصرف النظر عن نوع المفتاح. - خلاف ذلك، يحدّد مصدر المفتاح نقطة النهاية: تختار بادئة المفتاح المضبوط وسيلة النقل (يتقدّم الإعداد على متغيرات البيئة)؛ ويستخدم مفتاح البيئة نقطة النهاية المطابقة له مباشرةً.
| بادئة المفتاح | وسيلة النقل | الميزات |
|---|---|---|
pplx- |
واجهة Perplexity Search API الأصلية (https://api.perplexity.ai) |
نتائج منظّمة وعوامل تصفية للنطاق واللغة والتاريخ |
sk-or- |
OpenRouter (https://openrouter.ai/api/v1)، نموذج Sonar |
إجابات مولّدة بالذكاء الاصطناعي مع استشهادات |
يستخدم المفتاح المضبوط ذو أي بادئة أخرى واجهة Search API الأصلية أيضًا. يستخدم مسار إكمالات المحادثة نموذج perplexity/sonar-pro افتراضيًا؛ ويمكن تجاوزه باستخدام plugins.entries.perplexity.config.webSearch.model.
التصفية في واجهة API الأصلية
| عامل التصفية | الوصف | وسيلة النقل |
|---|---|---|
count |
عدد النتائج لكل بحث، من 1 إلى 10 (الافتراضي 5) | الأصلية فقط |
freshness |
نافذة الحداثة: day، week، month، year |
كلتاهما |
country |
رمز بلد من حرفين (us، de، jp) |
الأصلية فقط |
language |
رمز لغة ISO 639-1 (en، fr، zh) |
الأصلية فقط |
date_after / date_before |
نطاق تاريخ النشر بالتنسيق YYYY-MM-DD |
الأصلية فقط |
domain_filter |
20 نطاقًا كحد أقصى؛ قائمة سماح أو قائمة منع مسبوقة بـ -، ولا يجوز الجمع بينهما |
الأصلية فقط |
max_tokens / max_tokens_per_page |
ميزانية المحتوى عبر جميع النتائج / لكل صفحة | الأصلية فقط |
تعيد عوامل التصفية الخاصة بالواجهة الأصلية خطأً وصفيًا عند استخدامها في مسار إكمالات المحادثة.
لا يمكن الجمع بين freshness وdate_after/date_before.
الإعداد المتقدم
متغير البيئة لعمليات الخدمة الخلفية
إعداد وكيل OpenRouter
لتوجيه عمليات بحث Perplexity عبر OpenRouter، عيّن OPENROUTER_API_KEY (بالبادئة sk-or-) بدلًا من مفتاح Perplexity أصلي. يكتشف OpenClaw المفتاح وينتقل تلقائيًا إلى وسيلة نقل Sonar. يفيد ذلك إذا كنت قد أعددت الفوترة في OpenRouter وتريد توحيد الموفّرين هناك.
