Ana içeriğe atla
OpenClaw, web_search sağlayıcısı olarak Exa AI desteği sunar. Exa yerleşik içerik çıkarma (vurgular, metin, özetler) ile nöral, anahtar kelime ve hibrit arama modları sunar.

​
Plugin yükle

Resmi Plugin’i yükleyin, ardından Gateway’i yeniden başlatın: 
openclaw plugins install @openclaw/exa-plugin
openclaw gateway restart

​
API anahtarı alın

1

Hesap oluşturun

exa.ai adresinde kaydolun ve panonuzdan bir API anahtarı oluşturun.
2

Anahtarı saklayın

Gateway ortamında EXA_API_KEY ayarlayın veya şununla yapılandırın:
openclaw configure --section web

​
Yapılandırma

{
  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",
      },
    },
  },
}
Ortam alternatifi: Gateway ortamında EXA_API_KEY ayarlayın. Bir gateway kurulumu için bunu ~/.openclaw/.env içine koyun.

​
Temel URL geçersiz kılma

Exa arama isteklerinin uyumlu bir proxy veya alternatif Exa uç noktası üzerinden gitmesi gerektiğinde plugins.entries.exa.config.webSearch.baseUrl ayarlayın. OpenClaw, çıplak ana bilgisayar adlarını başına https:// ekleyerek normalleştirir ve yol zaten orada bitmiyorsa /search ekler. Çözümlenen uç nokta arama önbelleği anahtarına dahil edilir, bu nedenle farklı Exa uç noktalarından gelen sonuçlar paylaşılmaz.

​
Araç parametreleri

​
query
string
gerekli
Arama sorgusu.
​
count
number
Döndürülecek sonuçlar (1-100).
​
type
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
Arama modu.
​
freshness
'day' | 'week' | 'month' | 'year'
Zaman filtresi.
​
date_after
string
Bu tarihten sonraki sonuçlar (YYYY-MM-DD).
​
date_before
string
Bu tarihten önceki sonuçlar (YYYY-MM-DD).
​
contents
object
İçerik çıkarma seçenekleri (aşağıya bakın).

​
İçerik çıkarma

Exa, arama sonuçlarının yanında çıkarılmış içerik döndürebilir. Etkinleştirmek için bir contents nesnesi geçirin: 
await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // full page text
    highlights: { numSentences: 3 }, // key sentences
    summary: true, // AI summary
  },
});
İçerik seçeneğiTürAçıklama
textboolean | { maxCharacters }Tam sayfa metnini çıkar
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }Ana cümleleri çıkar
summaryboolean | { query }AI tarafından üretilen özet

​
Arama modları

ModAçıklama
autoExa en iyi modu seçer (varsayılan)
neuralAnlamsal/anlam tabanlı arama
fastHızlı anahtar kelime araması
deepKapsamlı derin arama
deep-reasoningAkıl yürütmeli derin arama
instantEn hızlı sonuçlar

​
Notlar

  • contents seçeneği sağlanmazsa, Exa varsayılan olarak { highlights: true } kullanır, böylece sonuçlar ana cümle alıntıları içerir
  • Sonuçlar, mevcut olduğunda Exa API yanıtındaki highlightScores ve summary alanlarını korur
  • Sonuç açıklamaları önce vurgulardan, ardından özetten, ardından tam metinden çözümlenir; hangisi mevcutsa
  • freshness ve date_after/date_before birleştirilemez; tek bir zaman filtresi modu kullanın
  • Sorgu başına en fazla 100 sonuç döndürülebilir (Exa arama türü sınırlarına tabidir)
  • Sonuçlar varsayılan olarak 15 dakika önbelleğe alınır (cacheTtlMinutes ile yapılandırılabilir)
  • Exa, yapılandırılmış JSON yanıtları olan resmi bir API entegrasyonudur

​
İlgili