OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Paralel arama

Parallel Plugin, yapay zekâ ajanları için oluşturulmuş bir web dizininden sıralanmış, LLM için optimize edilmiş alıntılar döndüren iki Parallel web_search sağlayıcısı sunar:

Sağlayıcı id Kimlik doğrulama
Parallel Search (Ücretsiz) parallel-free Yok -- Parallel'ın ücretsiz Search MCP hizmeti
Parallel Search parallel PARALLEL_API_KEY -- ücretli Search API, daha yüksek hız sınırları ve hedef ayarlama

Birini açıkça seçmek için tools.web.search.provider değerini parallel-free veya parallel olarak ayarlayın; hiçbiri otomatik olarak algılanmaz.

Plugin'i yükleme

bash
openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

API anahtarı (ücretli sağlayıcı)

parallel-free anahtar gerektirmez ancak yine de açıkça seçilmelidir. Ücretli parallel sağlayıcısı bir API anahtarı gerektirir:

  • Hesap oluşturun

    platform.parallel.ai adresinde kaydolun ve kontrol panelinizden bir API anahtarı oluşturun.

  • Anahtarı saklayın

    Gateway ortamında PARALLEL_API_KEY değişkenini ayarlayın veya şununla yapılandırın:

    bash
    openclaw configure --section web

    • Yapılandırma

    json5
    {  plugins: {    entries: {      parallel: {        config: {          webSearch: {            apiKey: "par-...", // PARALLEL_API_KEY ayarlanmışsa isteğe bağlı            baseUrl: "https://api.parallel.ai", // isteğe bağlı; OpenClaw /v1/search ekler          },        },      },    },  },  tools: {    web: {      search: {        // Ücretsiz Search MCP için "parallel-free" veya burada gösterilen        // ücretli API destekli sağlayıcı için "parallel".        provider: "parallel",      },    },  },}

    Ortam alternatifi: Gateway ortamında PARALLEL_API_KEY değişkenini ayarlayın. Bir Gateway kurulumu için bunu ~/.openclaw/.env dosyasına ekleyin.

    Temel URL'yi geçersiz kılma

    Yalnızca ücretli parallel sağlayıcısı için geçerlidir; parallel-free her zaman https://search.parallel.ai/mcp adresini kullanır ve bu ayarı yok sayar.

    Ücretli istekleri uyumlu bir proxy veya alternatif uç nokta (örneğin Cloudflare AI Gateway) üzerinden yönlendirmek için plugins.entries.parallel.config.webSearch.baseUrl değerini ayarlayın. OpenClaw, yalın ana bilgisayarların başına https:// ekleyerek bunları normalleştirir ve yol zaten bununla bitmiyorsa /v1/search ekler. Çözümlenen uç nokta, arama önbelleği anahtarının bir parçasıdır; bu nedenle farklı uç noktalardan gelen sonuçlar hiçbir zaman paylaşılmaz.

    Araç parametreleri

    Her iki sağlayıcı da Parallel'ın yerel arama biçimini sunar; böylece model, doğal dilde bir hedefin yanı sıra birkaç kısa anahtar sözcük sorgusu girer. Parallel, en iyi sonuçlar için bu eşleştirmeyi önerir.

    objectivestringrequired

    Temel sorunun veya hedefin doğal dilde açıklaması (en fazla 5000 karakter). Kendi başına anlaşılır olmalıdır.

    search_queriesstring[]required

    Her biri 3-6 sözcükten oluşan kısa anahtar sözcük arama sorguları (1-5 girdi, her biri en fazla 200 karakter). En iyi sonuçlar için birbirinden farklı 2-3 sorgu sağlayın.

    countnumber

    Döndürülecek sonuçlar (1-40).

    session_idstring

    Önceki bir sonucun sessionId değerinden alınan isteğe bağlı Parallel oturum kimliği. Parallel'ın ilişkili çağrıları gruplaması ve sonraki sonuçları iyileştirmesi için aynı görevdeki takip aramalarında bunu iletin. parallel için en fazla 1000 karakterdir; ücretsiz parallel-free Search MCP bunu 100 karakterle sınırlar. Sınırı aşan bir kimlik kaldırılır (ücretli) veya yeni bir kimlik oluşturulur (ücretsiz).

    client_modelstring

    Çağrıyı yapan modelin isteğe bağlı tanımlayıcısı (ör. claude-opus-4-7, gpt-5.6-sol), en fazla 100 karakter. Parallel'ın varsayılan ayarları modelinizin yeteneklerine göre uyarlamasını sağlar. Etkin modelin tam kısa adını iletin; bunu bir aile takma adına kısaltmayın.

    Notlar

    • Parallel, sonuçları insanların tıklaması için değil, LLM'in akıl yürütme açısından faydası için sıralar ve sıkıştırır; tam sayfa içerik yerine sonuç başına yoğun alıntılar bekleyin.
    • Sonuç alıntıları excerpts dizisi olarak döner ve genel web_search sözleşmesiyle uyumluluk için description alanında da birleştirilir.
    • Her iki sağlayıcı da bir session_id döndürür; OpenClaw, çağıranların takip aramalarını gruplandırabilmesi için bunu araç yükünde sessionId olarak sunar. Parallel tarafından oluşturulan bir oturum kimliği (çağıranın sağlamadığı bir kimlik), aynı sorgulara sahip ilgisiz görevlerin bunu devralmaması için önbellek girdisinin dışında tutulur.
    • Parallel'dan gelen searchId, warnings ve usage, mevcut olduklarında aynen aktarılır.
    • OpenClaw, çözümlenen sonuç sayısını her zaman Parallel'a advanced_settings.max_results (parallel) olarak iletir veya Parallel'ın sabit boyutlu yanıtından sonra count değerini istemci tarafında uygular (parallel-free). Önce çağıranın count argümanı, ardından tools.web.search.maxResults geçerli olur; aksi durumda OpenClaw'ın genel web_search varsayılanı (5) kullanılır. Parallel'ın kendi API'sinin varsayılanı 10'dur.
    • Sonuçlar varsayılan olarak 15 dakika önbelleğe alınır (cacheTtlMinutes).
    • Çağıran bir değer sağlamadığında parallel-free, MCP el sıkışması aracılığıyla her çağrı için yeni bir session_id oluşturur; parallel ise bu durumda değeri ayarlanmamış bırakır.

    İlgili içerikler

    Was this useful?
    On this page

    On this page