Skip to main content
Parallel plugin, her ikisi de 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: Birini açıkça seçmek için tools.web.search.provider değerini parallel-free veya parallel olarak ayarlayın; ikisi de otomatik olarak algılanmaz.
Doğrudan OpenAI Responses modelleri (api: "openai-responses", sağlayıcı openai, resmî API temel URL’si), tools.web.search.provider ayarlanmamış, boş, "auto" veya "openai" olduğunda OpenAI’ın barındırılan yerel web aramasını otomatik olarak kullanır; dolayısıyla varsayılan olarak Parallel’ı atlar. Bunları bunun yerine Parallel üzerinden yönlendirmek için tools.web.search.provider değerini parallel-free veya parallel olarak ayarlayın. Bkz. Web Aramasına genel bakış.

​
Plugin’i yükleme

​
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:
1

Hesap oluşturma

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

Anahtarı saklama

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

​
Yapılandırma

Ortam alternatifi: Gateway ortamında PARALLEL_API_KEY değişkenini ayarlayın. Bir gateway kurulumu için bunu ~/.openclaw/.env içine yerleştirin.

​
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 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, başına https:// ekleyerek yalnızca ana makine adından oluşan adresleri 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 hedef ile birkaç kısa anahtar sözcük sorgusunu doldurur. Bu eşleştirme, en iyi sonuçlar için Parallel tarafından önerilir.
​
string
gerekli
Temel sorunun veya hedefin doğal dilde açıklaması (en fazla 5000 karakter). Kendi başına anlaşılır olmalıdır.
​
string[]
gerekli
Kısa anahtar sözcük arama sorguları; her biri 3-6 sözcük (1-5 girdi, her biri en fazla 200 karakter). En iyi sonuçlar için birbirinden farklı 2-3 sorgu sağlayın.
​
number
Döndürülecek sonuç sayısı (1-40).
​
string
Önceki bir sonucun sessionId alanından alınan isteğe bağlı Parallel oturum kimliği. Parallel’ın ilgili çağrıları gruplandırması ve sonraki sonuçları iyileştirmesi için aynı görevdeki takip aramalarına bunu aktarın. parallel üzerinde en fazla 1000 karakterdir; ücretsiz parallel-free Search MCP bunu 100 ile sınırlar. Sınırı aşan bir kimlik kaldırılır (ücretli) veya yeni bir kimlik oluşturulur (ücretsiz).
​
string
Ç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ı aktarın; bir aile takma adına kısaltmayın.

​
Notlar

  • Parallel, sonuçları insanların bağlantılara tıklaması için değil, LLM akıl yürütme 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 içinde de 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 girdisine dahil edilmez.
  • Parallel’dan gelen searchId, warnings ve usage, mevcut olduklarında değiştirilmeden aktarılır.
  • OpenClaw, çözümlenmiş sonuç sayısını Parallel’a her zaman advanced_settings.max_results (parallel) olarak iletir veya Parallel’ın sabit boyutlu yanıtından sonra istemci tarafında count uygular (parallel-free). Önce çağıranın count argümanı, ardından tools.web.search.maxResults, aksi hâlde OpenClaw’ın genel web_search varsayılanı (5) geçerlidir; Parallel’ın kendi API varsayılanı 10’dur.
  • Sonuçlar varsayılan olarak 15 dakika önbelleğe alınır (cacheTtlMinutes).
  • Çağıran bir kimlik 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