Skip to main content
يدعم OpenClaw واجهة Perplexity Search API بوصفها مزودًا لـ web_search. وتُرجع نتائج منظَّمة تتضمن الحقول title وurl وsnippet. لأغراض التوافق، يدعم OpenClaw أيضًا إعدادات Perplexity Sonar/OpenRouter القديمة. إذا استخدمت OPENROUTER_API_KEY، أو مفتاحًا يبدأ بـ sk-or-... في plugins.entries.perplexity.config.webSearch.apiKey، أو عيّنت plugins.entries.perplexity.config.webSearch.baseUrl / model، فسيتحول المزود إلى مسار إكمالات المحادثة ويُرجع إجابات مولَّدة بالذكاء الاصطناعي مع استشهادات بدلًا من نتائج Search API المنظَّمة.

تثبيت Plugin

ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway:

الحصول على مفتاح Perplexity API

  1. أنشئ حساب Perplexity على perplexity.ai/settings/api.
  2. أنشئ مفتاح API في لوحة التحكم.
  3. خزّن المفتاح في الإعدادات أو عيّن PERPLEXITY_API_KEY في بيئة Gateway.

التوافق مع OpenRouter

إذا كنت تستخدم OpenRouter بالفعل مع Perplexity Sonar، فأبقِ provider: "perplexity" وعيّن OPENROUTER_API_KEY في بيئة Gateway، أو خزّن مفتاحًا يبدأ بـ sk-or-... في plugins.entries.perplexity.config.webSearch.apiKey. عناصر التحكم الاختيارية في التوافق:
  • plugins.entries.perplexity.config.webSearch.baseUrl
  • plugins.entries.perplexity.config.webSearch.model

أمثلة على الإعدادات

واجهة Perplexity Search API الأصلية

التوافق مع OpenRouter / Sonar

مكان تعيين المفتاح

عبر الإعدادات: شغّل openclaw configure --section web. يؤدي ذلك إلى تخزين المفتاح في ~/.openclaw/openclaw.json ضمن plugins.entries.perplexity.config.webSearch.apiKey. يقبل هذا الحقل أيضًا كائنات SecretRef. عبر البيئة: عيّن PERPLEXITY_API_KEY أو OPENROUTER_API_KEY في بيئة عملية Gateway. عند تثبيت Gateway، ضعه في ~/.openclaw/.env (أو في بيئة خدمتك). راجع متغيرات البيئة. إذا كان provider: "perplexity" مهيّأً وتعذر حل SecretRef الخاص بمفتاح Perplexity من دون قيمة احتياطية من البيئة، فسيفشل بدء التشغيل/إعادة التحميل فورًا.

معاملات الأداة

تنطبق هذه المعاملات على مسار Perplexity Search API الأصلي.
string
مطلوب
استعلام البحث.
number
افتراضي:"5"
عدد النتائج المطلوب إرجاعها (1-10).
string
رمز البلد وفق ISO والمكوّن من حرفين (مثل US وDE).
string
رمز اللغة وفق ISO 639-1 (مثل en وde وfr).
'day' | 'week' | 'month' | 'year'
مرشح زمني؛ تمثل day مدة 24 ساعة.
string
النتائج المنشورة بعد هذا التاريخ فقط (YYYY-MM-DD).
string
النتائج المنشورة قبل هذا التاريخ فقط (YYYY-MM-DD).
string[]
مصفوفة قائمة السماح/الحظر للنطاقات (بحد أقصى 20).
number
افتراضي:"25000"
إجمالي ميزانية المحتوى (بحد أقصى 1000000).
number
افتراضي:"2048"
حد الرموز لكل صفحة.
بالنسبة إلى مسار التوافق القديم مع Sonar/OpenRouter:
  • تُقبل query وcount وfreshness.
  • تُستخدم count لأغراض التوافق فقط في هذا المسار؛ إذ تظل الاستجابة إجابة واحدة مولَّدة مع استشهادات، وليست قائمة من N من النتائج.
  • تُرجع المرشحات الخاصة بواجهة Search API فقط (country وlanguage وdate_after وdate_before وdomain_filter وmax_tokens وmax_tokens_per_page) أخطاء صريحة.
أمثلة:

قواعد مرشح النطاقات

  • الحد الأقصى 20 نطاقًا لكل مرشح.
  • لا يمكن الجمع بين إدخالات قائمة السماح وقائمة الحظر في الطلب نفسه.
  • استخدم السابقة - لإدخالات قائمة الحظر (مثل ["-reddit.com"]).

ملاحظات

  • تُرجع Perplexity Search API نتائج بحث ويب منظَّمة (title وurl وsnippet).
  • يؤدي استخدام OpenRouter، أو تعيين plugins.entries.perplexity.config.webSearch.baseUrl / model صراحةً، إلى إعادة Perplexity إلى إكمالات محادثة Sonar لأغراض التوافق.
  • يُرجع التوافق مع Sonar/OpenRouter إجابة واحدة مولَّدة مع استشهادات، وليس صفوف نتائج منظَّمة.
  • تُخزَّن النتائج مؤقتًا لمدة 15 دقيقة افتراضيًا (يمكن ضبطها عبر cacheTtlMinutes).

موضوعات ذات صلة

نظرة عامة على بحث الويب

جميع المزودين وقواعد الاكتشاف التلقائي.

بحث Brave

نتائج منظَّمة مع مرشحات البلد واللغة.

بحث Exa

بحث عصبي مع استخراج المحتوى.

وثائق Perplexity Search API

دليل البدء السريع والمرجع الرسميان لواجهة Perplexity Search API.