جستجوی Exa

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

# دریافت کلید 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 باید از طریق یک پروکسی سازگار یا endpoint جایگزین Exa عبور کنند، plugins.entries.exa.config.webSearch.baseUrl را تنظیم کنید. OpenClaw میزبان‌های خام را با افزودن https:// به ابتدای آن‌ها عادی‌سازی می‌کند و /search را اضافه می‌کند مگر اینکه مسیر از قبل به آن ختم شده باشد. endpoint نهایی در کلید cache جست‌وجو گنجانده می‌شود، بنابراین نتایج endpointهای مختلف 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 را نمی‌توان با هم ترکیب کرد — از یک حالت فیلتر زمانی استفاده کنید
• در هر query می‌توان تا 100 نتیجه بازگرداند (با رعایت محدودیت‌های نوع جست‌وجوی Exa)
• نتایج به‌صورت پیش‌فرض برای 15 دقیقه cache می‌شوند (قابل پیکربندی از طریق cacheTtlMinutes)
• Exa یک یکپارچه‌سازی رسمی API با پاسخ‌های JSON ساختاریافته است

# مرتبط

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