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

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

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

​
بدء سريع

  1. اضبط API key:
openclaw configure --section web
أو اضبطها مباشرة: 
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
  1. سيستخدم الوكيل Perplexity تلقائيًا في عمليات البحث على الويب عند إعدادها.

​
أوضاع البحث

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

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

عند استخدام Perplexity API الأصلية ‏(مفتاح pplx-)، تدعم عمليات البحث:
  • Country: رمز بلد مكوّن من حرفين
  • Language: رمز لغة ISO 639-1
  • Date range: يوم، أسبوع، شهر، سنة
  • Domain filters: قائمة سماح/قائمة حظر (بحد أقصى 20 نطاقًا)
  • Content budget: ‏max_tokens, max_tokens_per_page

​
ملاحظة حول البيئة

إذا كانت Gateway تعمل كـ daemon ‏(launchd/systemd)، فتأكد من أن PERPLEXITY_API_KEY متاحة لتلك العملية (على سبيل المثال، في ~/.openclaw/.env أو عبر env.shellEnv).