يدعم OpenClaw واجهة Perplexity Search API كموفّر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.
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 المنظّمة.
الحصول على مفتاح Perplexity API
- أنشئ حساب Perplexity على perplexity.ai/settings/api
- أنشئ مفتاح API في لوحة التحكم
- خزّن المفتاح في الإعدادات أو اضبط
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.baseUrlplugins.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 الأصلي.استعلام البحث.
عدد النتائج المطلوب إرجاعها (1-10).
رمز البلد ISO المكوّن من حرفين (مثل
US، DE).رمز اللغة ISO 639-1 (مثل
en، de، fr).مرشح الوقت -
day يعني 24 ساعة.النتائج المنشورة بعد هذا التاريخ فقط (
YYYY-MM-DD).النتائج المنشورة قبل هذا التاريخ فقط (
YYYY-MM-DD).مصفوفة قائمة السماح/قائمة الحظر للنطاقات (الحد الأقصى 20).
إجمالي ميزانية المحتوى (الحد الأقصى 1000000).
حد الرموز لكل صفحة.
- يتم قبول
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.