جست‌وجوی Brave

OpenClaw از Brave Search API به‌عنوان ارائه‌دهندهٔ web_search پشتیبانی می‌کند.

دریافت کلید API

1. در https://brave.com/search/api/ یک حساب Brave Search API ایجاد کنید.
2. در داشبورد، طرح Search را انتخاب و یک کلید API ایجاد کنید.
3. کلید را در پیکربندی ذخیره کنید یا BRAVE_API_KEY را در محیط Gateway تنظیم کنید.

نمونهٔ پیکربندی

{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",            mode: "web", // یا "llm-context"            baseUrl: "https://api.search.brave.com", // بازنویسی اختیاری نشانی پایه/پروکسی          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

تنظیمات جست‌وجوی ویژهٔ ارائه‌دهندهٔ Brave در plugins.entries.brave.config.webSearch.* قرار می‌گیرند؛ این مسیر متعارف پیکربندی است. tools.web.search.apiKey مشترک در سطح بالا و tools.web.search.brave.* محدودشده همچنان از طریق ادغام سازگاری بارگذاری می‌شوند، اما پیکربندی جدید باید از مسیر محدود به Plugin در بالا استفاده کند.

webSearch.mode انتقال Brave را کنترل می‌کند:

• web (پیش‌فرض): جست‌وجوی عادی وب Brave با عنوان‌ها، نشانی‌های URL و قطعه‌های متنی
• llm-context: ‏Brave LLM Context API با بخش‌های متنی و منابع ازپیش‌استخراج‌شده برای استنادپذیری

webSearch.baseUrl می‌تواند درخواست‌های Brave را به یک پروکسی یا Gateway سازگار با Brave و مورد اعتماد هدایت کند. OpenClaw مسیر /res/v1/web/search یا /res/v1/llm/context را به نشانی پایهٔ پیکربندی‌شده می‌افزاید و نشانی پایه را در کلید کش نگه می‌دارد. نقاط پایانی عمومی باید از https:// استفاده کنند؛ http:// فقط برای local loopback مورد اعتماد یا میزبان‌های پروکسی شبکهٔ خصوصی پذیرفته می‌شود.

پارامترهای ابزار

نمونه‌ها:

// جست‌وجوی مختص کشور و زبانawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // نتایج اخیر (هفتهٔ گذشته)await web_search({  query: "AI news",  freshness: "week",}); // جست‌وجو در بازهٔ تاریخیawait web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",});

نکات

• OpenClaw از طرح Search در Brave استفاده می‌کند. اگر اشتراک قدیمی دارید (برای نمونه طرح اصلی Free با ۲٬۰۰۰ پرس‌وجو در ماه)، همچنان معتبر است، اما قابلیت‌های جدیدتر مانند LLM Context یا محدودیت نرخ بالاتر را شامل نمی‌شود.
• هر طرح Brave شامل اعتبار رایگان ماهانهٔ ۵ دلار است که تمدید می‌شود. هزینهٔ طرح Search برای هر ۱٬۰۰۰ درخواست ۵ دلار است؛ بنابراین این اعتبار هزینهٔ ۱٬۰۰۰ پرس‌وجو در ماه را پوشش می‌دهد. برای جلوگیری از هزینه‌های غیرمنتظره، محدودیت مصرف خود را در داشبورد 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 داشته باشد.
• نتایج به‌طور پیش‌فرض به‌مدت ۱۵ دقیقه کش می‌شوند (از طریق cacheTtlMinutes قابل پیکربندی است).
• مقادیر سفارشی webSearch.baseUrl در شناسهٔ کش Brave لحاظ می‌شوند تا پاسخ‌های مختص پروکسی با یکدیگر تداخل نداشته باشند.
• برای ثبت نشانی‌های URL/پارامترهای پرس‌وجوی درخواست Brave، وضعیت/زمان‌بندی پاسخ و رویدادهای اصابت/عدم اصابت/نوشتن در کش جست‌وجو هنگام عیب‌یابی، پرچم تشخیصی brave.http را فعال کنید. این پرچم هرگز کلید API یا بدنهٔ پاسخ را ثبت نمی‌کند، اما پرس‌وجوهای جست‌وجو می‌توانند حساس باشند.

مرتبط

• نمای کلی جست‌وجوی وب -- همهٔ ارائه‌دهندگان و تشخیص خودکار
• جست‌وجوی Perplexity -- نتایج ساختاریافته با پالایش دامنه
• جست‌وجوی Exa -- جست‌وجوی عصبی با استخراج محتوا