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

بحث DuckDuckGo

يدعم OpenClaw استخدام DuckDuckGo كموفر web_search لا يتطلب مفتاحًا. لا حاجة إلى مفتاح API أو حساب.
DuckDuckGo تكامل تجريبي وغير رسمي يستخرج النتائج من صفحات البحث غير المعتمدة على JavaScript في DuckDuckGo — وليس من API رسمي. توقّع حدوث أعطال أحيانًا بسبب صفحات تحديات البوتات أو تغييرات HTML.

الإعداد

لا حاجة إلى مفتاح API — فقط اضبط DuckDuckGo كموفر لك:
1

التهيئة

openclaw configure --section web
# Select "duckduckgo" as the provider

الإعدادات

{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}
إعدادات اختيارية على مستوى plugin للمنطقة وSafeSearch:
{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo region code
            safeSearch: "moderate", // "strict", "moderate", or "off"
          },
        },
      },
    },
  },
}

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

المعاملالوصف
queryاستعلام البحث (مطلوب)
countالنتائج المراد إرجاعها (1-10، الافتراضي: 5)
regionرمز منطقة DuckDuckGo (مثل us-en أو uk-en أو de-de)
safeSearchمستوى SafeSearch: ‏strict أو moderate (الافتراضي) أو off
يمكن أيضًا ضبط المنطقة وSafeSearch في إعدادات plugin (انظر أعلاه) — معاملات الأداة تتجاوز قيم الإعدادات لكل استعلام.

ملاحظات

  • لا يوجد مفتاح API — يعمل مباشرة، من دون أي إعداد
  • تجريبي — يجمع النتائج من صفحات بحث HTML غير المعتمدة على JavaScript الخاصة بـ DuckDuckGo، وليس من API أو SDK رسمي
  • خطر تحديات البوتات — قد يعرض DuckDuckGo اختبارات CAPTCHA أو يحظر الطلبات عند الاستخدام الكثيف أو المؤتمت
  • تحليل HTML — تعتمد النتائج على بنية الصفحة، والتي قد تتغير من دون إشعار
  • ترتيب الاكتشاف التلقائي — DuckDuckGo هو أول بديل احتياطي لا يتطلب مفتاحًا (الترتيب 100) في الاكتشاف التلقائي. موفرو الخدمة المعتمدون على API مع مفاتيح مُعدّة يعملون أولًا، ثم Ollama Web Search (الترتيب 110)، ثم SearXNG (الترتيب 200)
  • تكون قيمة SafeSearch الافتراضية moderate عندما لا يكون مضبوطًا
للاستخدام الإنتاجي، فكّر في Brave Search (تتوفر فئة مجانية) أو موفر آخر يعتمد على API.

ذو صلة