جستجوی Exa

OpenClaw از Exa AI به‌عنوان ارائه‌دهنده‌ی web_search پشتیبانی می‌کند. Exa حالت‌های جست‌وجوی عصبی، کلیدواژه‌ای و ترکیبی را همراه با استخراج داخلی محتوا (برجسته‌سازی‌ها، متن، خلاصه‌ها) ارائه می‌دهد.

نصب Plugin

Plugin رسمی را نصب کنید، سپس Gateway را بازراه‌اندازی کنید:

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

دریافت کلید API

openclaw configure --section web

پیکربندی

{  plugins: {    entries: {      exa: {        config: {          webSearch: {            apiKey: "exa-...", // optional if EXA_API_KEY is set            baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

جایگزین محیطی: EXA_API_KEY را در محیط Gateway تنظیم کنید. برای نصب gateway، آن را در ~/.openclaw/.env قرار دهید.

بازنویسی URL پایه

وقتی درخواست‌های جست‌وجوی Exa باید از یک پراکسی سازگار یا نقطه پایانی جایگزین Exa عبور کنند، plugins.entries.exa.config.webSearch.baseUrl را تنظیم کنید. OpenClaw میزبان‌های بدون طرح را با افزودن https:// در ابتدا عادی‌سازی می‌کند و /search را اضافه می‌کند، مگر اینکه مسیر از قبل به آن ختم شود. نقطه پایانی حل‌شده در کلید کش جست‌وجو گنجانده می‌شود، بنابراین نتایج از نقاط پایانی مختلف Exa با هم به اشتراک گذاشته نمی‌شوند.

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

استخراج محتوا

Exa می‌تواند محتوای استخراج‌شده را در کنار نتایج جست‌وجو برگرداند. برای فعال‌سازی، یک شیء contents ارسال کنید:

await web_search({  query: "transformer architecture explained",  type: "neural",  contents: {    text: true, // full page text    highlights: { numSentences: 3 }, // key sentences    summary: true, // AI summary  },});

حالت‌های جست‌وجو

نکات

• اگر گزینه‌ی contents ارائه نشود، Exa به‌طور پیش‌فرض از { highlights: true } استفاده می‌کند تا نتایج شامل گزیده‌های جمله‌های کلیدی باشند
• نتایج، در صورت موجود بودن، فیلدهای highlightScores و summary را از پاسخ API Exa حفظ می‌کنند
• توضیحات نتیجه ابتدا از برجسته‌سازی‌ها، سپس خلاصه، و سپس متن کامل حل می‌شوند — هرکدام که موجود باشد
• freshness و date_after/date_before را نمی‌توان با هم ترکیب کرد — از یک حالت فیلتر زمانی استفاده کنید
• در هر پرس‌وجو می‌توان تا ۱۰۰ نتیجه برگرداند (مشروط به محدودیت‌های نوع جست‌وجوی Exa)
• نتایج به‌طور پیش‌فرض برای ۱۵ دقیقه کش می‌شوند (قابل پیکربندی از طریق cacheTtlMinutes)
• Exa یک یکپارچه‌سازی رسمی API با پاسخ‌های ساخت‌یافته JSON است

مرتبط

• نمای کلی Web Search -- همه ارائه‌دهندگان و تشخیص خودکار
• Brave Search -- نتایج ساخت‌یافته با فیلترهای کشور/زبان
• Perplexity Search -- نتایج ساخت‌یافته با فیلتر دامنه