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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
البدء

1

تعيين مفتاح API

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

بدء البحث

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

​
أوضاع البحث

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

​
ذو صلة

أداة بحث Perplexity

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

مرجع التهيئة

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