Tools
جستوجوی Brave
OpenClaw از Brave Search API بهعنوان ارائهدهندهٔ web_search پشتیبانی میکند.
دریافت کلید API
- یک حساب Brave Search API در https://brave.com/search/api/ ایجاد کنید.
- در داشبورد، طرح Search را انتخاب و یک کلید API ایجاد کنید.
- کلید را در پیکربندی ذخیره کنید یا
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.* قرار دارند؛ این مسیر متعارف پیکربندی است.
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:// فقط برای میزبانهای پراکسی loopback مورداعتماد
یا شبکهٔ خصوصی پذیرفته میشود.
پارامترهای ابزار
querystringrequiredعبارت جستوجو.
countnumberdefault: 5تعداد نتایجی که باید بازگردانده شوند (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).
نمونهها:
// جستوجوی ویژهٔ کشور و زبان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 با 2,000 درخواست در ماه)، همچنان معتبر است، اما قابلیتهای جدیدتر مانند LLM Context یا محدودیت نرخ بالاتر را شامل نمیشود.
- هر طرح Brave شامل اعتبار رایگان ماهانهٔ $5 (با تمدید ماهانه) است. طرح Search برای هر 1,000 درخواست، $5 هزینه دارد؛ بنابراین این اعتبار 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 گنجانده میشوند تا پاسخهای ویژهٔ پراکسی با یکدیگر تداخل نکنند. - برای ثبت نشانیهای URL و پارامترهای درخواست Brave، وضعیت و زمانبندی پاسخ، و رویدادهای اصابت/عدماصابت/نوشتن کش جستوجو هنگام عیبیابی، پرچم تشخیصی
brave.httpرا فعال کنید. این پرچم هرگز کلید API یا بدنهٔ پاسخها را ثبت نمیکند، اما عبارتهای جستوجو ممکن است حساس باشند.
مطالب مرتبط
- نمای کلی جستوجوی وب -- همهٔ ارائهدهندگان و تشخیص خودکار
- جستوجوی Perplexity -- نتایج ساختاریافته با پالایش دامنه
- جستوجوی Exa -- جستوجوی عصبی با استخراج محتوا
