> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# بحث DuckDuckGo

يدعم OpenClaw DuckDuckGo كمزوّد `web_search` **بدون مفتاح**. لا يلزم مفتاح API
أو حساب.

<Warning>
  DuckDuckGo هو تكامل **تجريبي وغير رسمي** يجلب النتائج
  من صفحات بحث DuckDuckGo غير المعتمدة على JavaScript - وليس API رسمية. توقّع
  حدوث أعطال عرضية بسبب صفحات تحدّي الروبوتات أو تغييرات HTML.
</Warning>

## الإعداد

لا حاجة إلى مفتاح API - ما عليك سوى تعيين DuckDuckGo كمزوّدك:

<Steps>
  <Step title="Configure">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    # Select "duckduckgo" as the provider
    ```
  </Step>
</Steps>

## الإعدادات

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}
```

إعدادات اختيارية على مستوى Plugin للمنطقة وSafeSearch:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo region code
            safeSearch: "moderate", // "strict", "moderate", or "off"
          },
        },
      },
    },
  },
}
```

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

<ParamField path="query" type="string" required>
  استعلام البحث.
</ParamField>

<ParamField path="count" type="number" default="5">
  النتائج المراد إرجاعها (1-10).
</ParamField>

<ParamField path="region" type="string">
  رمز منطقة DuckDuckGo (مثل `us-en` و`uk-en` و`de-de`).
</ParamField>

<ParamField path="safeSearch" type="'strict' | 'moderate' | 'off'" default="moderate">
  مستوى SafeSearch.
</ParamField>

يمكن أيضًا تعيين المنطقة وSafeSearch في إعدادات Plugin (انظر أعلاه) - تتجاوز
معاملات الأداة قيم الإعدادات لكل استعلام.

## ملاحظات

* **لا يوجد مفتاح API** - يعمل بعد اختيار DuckDuckGo كمزوّد `web_search`
  لديك
* **تجريبي** - يجمع النتائج من صفحات بحث HTML غير المعتمدة على JavaScript
  في DuckDuckGo، وليس من API أو SDK رسمية
* **خطر تحدّي الروبوتات** - قد يعرض DuckDuckGo اختبارات CAPTCHA أو يحظر الطلبات
  عند الاستخدام الكثيف أو المؤتمت
* **تحليل HTML** - تعتمد النتائج على بنية الصفحة، والتي يمكن أن تتغير دون
  إشعار
* **اختيار صريح** - لا يختار OpenClaw DuckDuckGo تلقائيًا
  عند عدم إعداد مزوّد مدعوم بـ API
* **يكون SafeSearch على مستوى moderate افتراضيًا** عند عدم إعداده

<Tip>
  للاستخدام في الإنتاج، فكّر في [Brave Search](/ar/tools/brave-search) (تتوفر طبقة
  مجانية) أو مزوّد آخر مدعوم بـ API.
</Tip>

## ذات صلة

* [نظرة عامة على بحث الويب](/ar/tools/web) -- جميع المزوّدين والاكتشاف التلقائي
* [Brave Search](/ar/tools/brave-search) -- نتائج منظّمة مع طبقة مجانية
* [Exa Search](/ar/tools/exa-search) -- بحث عصبي مع استخراج المحتوى