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

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.

يدعم 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 المنظّمة.

الحصول على مفتاح 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 الأصلية

{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "pplx-...",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "perplexity",
      },
    },
  },
}

توافق OpenRouter / Sonar

{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "<openrouter-api-key>",
            baseUrl: "https://openrouter.ai/api/v1",
            model: "perplexity/sonar-pro",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "perplexity",
      },
    },
  },
}

أين تضبط المفتاح

عبر الإعدادات: شغّل 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 الأصلي.
query
string
مطلوب
استعلام البحث.
count
number
افتراضي:"5"
عدد النتائج المطلوب إرجاعها (1-10).
country
string
رمز البلد ISO المكوّن من حرفين (مثل US، DE).
language
string
رمز اللغة ISO 639-1 (مثل en، de، fr).
freshness
'day' | 'week' | 'month' | 'year'
مرشح الوقت - day يعني 24 ساعة.
date_after
string
النتائج المنشورة بعد هذا التاريخ فقط (YYYY-MM-DD).
date_before
string
النتائج المنشورة قبل هذا التاريخ فقط (YYYY-MM-DD).
domain_filter
string[]
مصفوفة قائمة السماح/قائمة الحظر للنطاقات (الحد الأقصى 20).
max_tokens
number
افتراضي:"25000"
إجمالي ميزانية المحتوى (الحد الأقصى 1000000).
max_tokens_per_page
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 تُرجع أخطاء صريحة
أمثلة:
// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Domain filtering (allowlist)
await web_search({
  query: "climate research",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

// Domain filtering (denylist - prefix with -)
await web_search({
  query: "product reviews",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// More content extraction
await web_search({
  query: "detailed AI research",
  max_tokens: 50000,
  max_tokens_per_page: 4096,
});

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

  • 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.