Providers
Perplexity
يوفّر Plugin Perplexity إمكانات بحث الويب عبر واجهة برمجة تطبيقات Perplexity Search API أو Perplexity Sonar عبر OpenRouter.
| الخاصية | القيمة |
|---|---|
| النوع | مزوّد بحث ويب (وليس مزوّد نماذج) |
| المصادقة | PERPLEXITY_API_KEY (مباشر) أو OPENROUTER_API_KEY (عبر OpenRouter) |
| مسار التكوين | plugins.entries.perplexity.config.webSearch.apiKey |
تثبيت Plugin
ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway:
openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restartبدء الاستخدام
تعيين مفتاح واجهة برمجة التطبيقات
شغّل مسار تكوين بحث الويب التفاعلي:
openclaw configure --section webأو عيّن المفتاح مباشرة:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"بدء البحث
سيستخدم الوكيل Perplexity تلقائيًا لعمليات بحث الويب بعد تكوين المفتاح. لا يلزم اتخاذ أي خطوات إضافية.
أوضاع البحث
يختار Plugin وسيلة النقل تلقائيًا بناءً على بادئة مفتاح واجهة برمجة التطبيقات:
واجهة Perplexity API الأصلية (pplx-)
عندما يبدأ مفتاحك بـ pplx-، يستخدم OpenClaw واجهة Perplexity Search
API الأصلية. تُرجع وسيلة النقل هذه نتائج منظّمة وتدعم مرشحات النطاق واللغة
والتاريخ (راجع خيارات التصفية أدناه).
OpenRouter / Sonar (sk-or-)
عندما يبدأ مفتاحك بـ sk-or-، يوجّه OpenClaw الطلب عبر OpenRouter باستخدام
نموذج Perplexity Sonar. تُرجع وسيلة النقل هذه إجابات مولّدة بالذكاء الاصطناعي مع
استشهادات.
| بادئة المفتاح | وسيلة النقل | الميزات |
|---|---|---|
pplx- |
Perplexity Search API الأصلية | نتائج منظّمة، ومرشحات النطاق/اللغة/التاريخ |
sk-or- |
OpenRouter (Sonar) | إجابات مولّدة بالذكاء الاصطناعي مع استشهادات |
تصفية واجهة API الأصلية
عند استخدام واجهة Perplexity API الأصلية، تدعم عمليات البحث المرشحات التالية:
| المرشح | الوصف | المثال |
|---|---|---|
| البلد | رمز بلد من حرفين | us, de, jp |
| اللغة | رمز لغة ISO 639-1 | en, fr, zh |
| نطاق التاريخ | نافذة الحداثة | day, week, month, year |
| مرشحات النطاق | قائمة سماح أو قائمة حظر (20 نطاقًا كحد أقصى) | example.com |
| ميزانية المحتوى | حدود الرموز لكل استجابة / لكل صفحة | max_tokens, max_tokens_per_page |
التكوين المتقدم
متغير بيئة لعمليات الخادم الخلفية
إذا كان OpenClaw Gateway يعمل كعملية خادم خلفية (launchd/systemd)، فتأكد من أن
PERPLEXITY_API_KEY متاح لتلك العملية.
إعداد وكيل OpenRouter
إذا كنت تفضّل توجيه عمليات بحث Perplexity عبر OpenRouter، فعيّن
OPENROUTER_API_KEY (بالبادئة sk-or-) بدلًا من مفتاح Perplexity أصلي.
سيكتشف OpenClaw البادئة وينتقل إلى وسيلة نقل Sonar
تلقائيًا.
