Ana içeriğe atla
Parallel Plugin’i iki Parallel web_search sağlayıcısı sunar:
  • Parallel Search (Free) (parallel-free) — Parallel’ın ücretsiz Search MCP hizmeti. Hesap veya API anahtarı gerektirmez. Parallel’ın barındırılan, anahtarsız arama yolunu istediğinizde bunu açıkça seçin.
  • Parallel Search (parallel) — Parallel’ın ücretli Search API’si. Bir PARALLEL_API_KEY gerektirir ve daha yüksek hız limitleri ile hedef ayarı sunar.
İkisi de AI agent’ları için oluşturulmuş bir web dizininden sıralanmış, LLM için optimize edilmiş alıntılar döndürür. Birini açıkça seçmek için tools.web.search.provider değerini parallel-free veya parallel olarak ayarlayın.
OpenAI Responses modelleri, tools.web.search.provider ayarlanmamışsa OpenAI’ın yerel web aramasını kullanır, bu nedenle Parallel sağlayıcılarını atlarlar. Onları Parallel üzerinden yönlendirmek için tools.web.search.provider değerini parallel-free veya parallel olarak ayarlayın.

​
Plugin’i yükleyin

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

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

parallel-free API anahtarı gerektirmez, ancak yine de yönetilen sağlayıcı olarak seçilmelidir. Ücretli parallel sağlayıcısı bir API anahtarı gerektirir:
1

Hesap oluşturun

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

Anahtarı depolayın

Gateway ortamında PARALLEL_API_KEY ayarlayın veya şu komutla yapılandırın:
openclaw configure --section web

​
Yapılandırma

{
  plugins: {
    entries: {
      parallel: {
        config: {
          webSearch: {
            apiKey: "par-...", // optional if PARALLEL_API_KEY is set
            baseUrl: "https://api.parallel.ai", // optional; OpenClaw appends /v1/search
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        // Use "parallel-free" for the free Search MCP, or "parallel" for
        // the paid API-backed provider shown here.
        provider: "parallel",
      },
    },
  },
}
Ortam alternatifi: Gateway ortamında PARALLEL_API_KEY ayarlayın. Bir gateway kurulumu için bunu ~/.openclaw/.env içine koyun.

​
Temel URL geçersiz kılma

Temel URL geçersiz kılması yalnızca ücretli parallel sağlayıcısına uygulanır. Ücretsiz parallel-free sağlayıcısı her zaman https://search.parallel.ai/mcp kullanır. Parallel isteklerinin uyumlu bir proxy veya alternatif Parallel uç noktası (örneğin Cloudflare AI Gateway) üzerinden gitmesi gerektiğinde plugins.entries.parallel.config.webSearch.baseUrl ayarlayın. OpenClaw, çıplak ana makine adlarını başına https:// ekleyerek normalleştirir ve yol zaten orada bitmiyorsa /v1/search ekler. Çözümlenen uç nokta arama önbellek anahtarına dahil edilir, bu nedenle farklı Parallel uç noktalarından gelen sonuçlar paylaşılmaz.

​
Araç parametreleri

OpenClaw, modelin hem doğal dildeki hedefi hem de birkaç kısa anahtar kelime sorgusunu doldurabilmesi için Parallel’ın yerel arama şeklini sunar; bu eşleştirme, Parallel’ın en iyi sonuçlar için önerdiği yaklaşımdır.
​
objective
string
gerekli
Alttaki sorunun veya hedefin doğal dilde açıklaması (en fazla 5000 karakter). Kendi başına anlaşılır olmalıdır.
​
search_queries
string[]
gerekli
Kısa anahtar kelime arama sorguları, her biri 3-6 kelime (1-5 giriş, her biri en fazla 200 karakter). En iyi sonuçlar için 2-3 çeşitli sorgu sağlayın.
​
count
number
Döndürülecek sonuç sayısı (1-40).
​
session_id
string
İsteğe bağlı Parallel oturum kimliği (parallel üzerinde en fazla 1000 karakter; ücretsiz parallel-free Search MCP bunu 100 ile sınırlar). Aynı görevin parçası olan takip aramalarında önceki bir Parallel sonucundan gelen sessionId değerini geçirin; böylece Parallel ilgili çağrıları gruplayabilir ve sonraki sonuçları iyileştirebilir. Sınırı aşan bir kimlik atılır ve yeni bir kimlik oluşturulur.
​
client_model
string
Çağrıyı yapan modelin isteğe bağlı tanımlayıcısı (örn. claude-opus-4-7, gpt-5.5). Parallel’ın modelinizin yeteneklerine göre varsayılan ayarları uyarlamasını sağlar. Tam etkin model slug’ını geçirin; bir aile takma adına kısaltmayın.

​
Notlar

  • Parallel, sonuçları insan tıklama oranına göre değil LLM akıl yürütme faydasına göre sıralar ve sıkıştırır; tam sayfa içerik yerine her sonuçta 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
  • Parallel her yanıtta bir session_id döndürür; OpenClaw bunu araç yükünde sessionId olarak sunar, böylece çağıranlar takip aramalarını gruplayabilir
  • Parallel’dan gelen searchId, warnings ve usage mevcut olduklarında aynen geçirilir
  • OpenClaw, çözümlenmiş sonuç sayısını her zaman Parallel’a advanced_settings.max_results olarak iletir. Önce çağıranın count argümanı, sonra üst düzey tools.web.search.maxResults ayarı kazanır; aksi halde OpenClaw’ın genel web_search varsayılanı (5) kullanılır. Bu, sağlayıcılar arasında geçiş yaparken sonuç hacmini tutarlı tutar; Parallel kendi başına varsayılan olarak 10 kullanır
  • Sonuçlar varsayılan olarak 15 dakika önbelleğe alınır (cacheTtlMinutes ile yapılandırılabilir)
  • Ücretsiz parallel-free sağlayıcısı aynı parametreleri kabul eder. count değerini istemci tarafında uygular ve sağlanmadığında her çağrı için bir session_id oluşturur.

​
İlgili