English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Tools

بحث Brave

OpenClaw يدعم Brave Search API كمزود web_search.

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

  1. أنشئ حساب Brave Search API على https://brave.com/search/api/
  2. في لوحة التحكم، اختر خطة Search وأنشئ مفتاح API.
  3. خزّن المفتاح في الإعدادات أو اضبط BRAVE_API_KEY في بيئة Gateway.

مثال الإعدادات

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
            baseUrl: "https://api.search.brave.com", // optional proxy/base URL override
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

إعدادات بحث Brave الخاصة بالمزود أصبحت الآن ضمن plugins.entries.brave.config.webSearch.*. لا يزال tools.web.search.apiKey القديم يُحمّل عبر طبقة التوافق، لكنه لم يعد مسار الإعدادات المعتمد.

يتحكم webSearch.mode في نقل Brave:

  • web (الافتراضي): بحث ويب Brave عادي مع عناوين وروابط URL ومقتطفات
  • llm-context: Brave LLM Context API مع مقاطع نصية ومصادر مستخرجة مسبقًا للتأصيل

يمكن أن يشير webSearch.baseUrl بطلبات Brave إلى وكيل موثوق متوافق مع Brave أو gateway. يضيف OpenClaw المسار /res/v1/web/search أو /res/v1/llm/context إلى عنوان URL الأساسي المضبوط، ويحافظ على عنوان URL الأساسي في مفتاح التخزين المؤقت. يجب أن تستخدم نقاط النهاية العامة https://؛ ولا يُقبل http:// إلا لمضيفي local loopback الموثوقين أو مضيفي وكلاء الشبكات الخاصة.

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

querystringrequired

استعلام البحث.

countnumber

عدد النتائج المراد إرجاعها (1–10).

countrystring

رمز البلد وفق ISO من حرفين (مثل US وDE).

languagestring

رمز لغة ISO 639-1 لنتائج البحث (مثل en وde وfr).

search_langstring

رمز لغة البحث في Brave (مثل en وen-gb وzh-hans).

ui_langstring

رمز لغة ISO لعناصر واجهة المستخدم.

freshness'day' | 'week' | 'month' | 'year'

مرشح الوقت — day تعني 24 ساعة.

date_afterstring

النتائج المنشورة بعد هذا التاريخ فقط (YYYY-MM-DD).

date_beforestring

النتائج المنشورة قبل هذا التاريخ فقط (YYYY-MM-DD).

أمثلة:

// 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",
});

ملاحظات

  • يستخدم OpenClaw خطة Search من Brave. إذا كان لديك اشتراك قديم (مثل الخطة Free الأصلية مع 2,000 استعلام/شهر)، فسيظل صالحًا لكنه لا يتضمن ميزات أحدث مثل LLM Context أو حدود معدلات أعلى.
  • تتضمن كل خطة من Brave رصيدًا مجانيًا قدره $5/شهر (يتجدد). تبلغ تكلفة خطة Search ‏$5 لكل 1,000 طلب، لذا يغطي الرصيد 1,000 استعلام/شهر. اضبط حد الاستخدام في لوحة تحكم Brave لتجنب الرسوم غير المتوقعة. راجع بوابة Brave API للاطلاع على الخطط الحالية.
  • تتضمن خطة Search نقطة نهاية LLM Context وحقوق استدلال الذكاء الاصطناعي. يتطلب تخزين النتائج لتدريب النماذج أو ضبطها خطة ذات حقوق تخزين صريحة. راجع شروط خدمة Brave.
  • يعيد وضع llm-context إدخالات مصادر مؤصلة بدلًا من شكل مقتطفات بحث الويب العادي.
  • يدعم وضع llm-context النطاقات freshness والنطاقات المحددة بـ date_after + date_before. ولا يدعم ui_lang؛ ويتم رفض date_before بدون date_after لأن Brave يتطلب أن تتضمن نطاقات الحداثة المخصصة تاريخي بداية ونهاية.
  • يجب أن يتضمن ui_lang وسمًا فرعيًا للمنطقة مثل en-US.
  • تُخزّن النتائج مؤقتًا لمدة 15 دقيقة افتراضيًا (قابلة للضبط عبر cacheTtlMinutes).
  • تُضمّن قيم webSearch.baseUrl المخصصة في هوية ذاكرة التخزين المؤقت لـ Brave، بحيث لا تتصادم الاستجابات الخاصة بالوكيل.
  • فعّل علم التشخيصات brave.http لتسجيل عناوين URL/معاملات الاستعلام لطلبات Brave، وحالة الاستجابة/توقيتها، وأحداث إصابة/فوات/كتابة ذاكرة التخزين المؤقت للبحث أثناء استكشاف المشكلات وإصلاحها. لا يسجل العلم مفتاح API أو أجسام الاستجابات مطلقًا، لكن استعلامات البحث قد تكون حساسة.

ذات صلة