Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw, web_search sağlayıcısı olarak Exa AI desteği sunar. Exa, yerleşik içerik çıkarımıyla (vurgular, metin, özetler) neural, anahtar kelime ve hibrit arama modları sunar.

API anahtarı alma

1

Hesap oluşturun

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

Anahtarı saklayın

Gateway ortamında EXA_API_KEY ayarlayın veya şu şekilde 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 geçmesi gerektiğinde plugins.entries.exa.config.webSearch.baseUrl ayarlayın. OpenClaw, yalın ana makinelerin başına https:// ekleyerek normalleştirir ve yol zaten orada bitmiyorsa /search ekler. Çözümlenen uç nokta arama önbellek anahtarına dahil edilir; böylece 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 çıkarımı seçenekleri (aşağıya bakın).

İçerik çıkarımı

Exa, arama sonuçlarının yanında çıkarılmış içerik döndürebilir. Etkinleştirmek için bir contents nesnesi iletin:
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 }Önemli cümleleri çıkar
summaryboolean | { query }Yapay zeka tarafından oluşturulan özet

Arama modları

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

Notlar

  • Hiçbir contents seçeneği sağlanmazsa Exa varsayılan olarak { highlights: true } kullanır; böylece sonuçlar önemli cümle alıntıları içerir
  • Kullanılabilir olduğunda sonuçlar, Exa API yanıtındaki highlightScores ve summary alanlarını korur
  • Sonuç açıklamaları önce vurgulardan, sonra özetten, sonra da tam metinden çözümlenir; hangisi kullanılabilirse
  • freshness ve date_after/date_before birlikte kullanılamaz; 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ı sunan resmi bir API entegrasyonudur

İlgili