Skip to main content
Plugin Parallel menyediakan dua penyedia web_search Parallel, yang keduanya mengembalikan kutipan berperingkat dan dioptimalkan untuk LLM dari indeks web yang dibangun untuk agen AI: Atur tools.web.search.provider ke parallel-free atau parallel untuk memilih salah satunya secara eksplisit; keduanya tidak dideteksi secara otomatis.
Model OpenAI Responses langsung (api: "openai-responses", penyedia openai, URL dasar API resmi) secara otomatis menggunakan pencarian web native yang dihosting OpenAI ketika tools.web.search.provider tidak diatur, kosong, "auto", atau "openai" — sehingga secara default melewati Parallel. Atur tools.web.search.provider ke parallel-free atau parallel agar permintaan diarahkan melalui Parallel. Lihat ikhtisar Pencarian Web.

​
Instal Plugin

​
Kunci API (penyedia berbayar)

parallel-free tidak memerlukan kunci, tetapi tetap harus dipilih secara eksplisit. Penyedia parallel berbayar memerlukan kunci API:
1

Buat akun

Daftar di platform.parallel.ai dan buat kunci API dari dasbor Anda.
2

Simpan kunci

Atur PARALLEL_API_KEY di lingkungan Gateway, atau konfigurasikan melalui:

​
Konfigurasi

Alternatif lingkungan: atur PARALLEL_API_KEY di lingkungan Gateway. Untuk instalasi Gateway, letakkan di ~/.openclaw/.env.

​
Penggantian URL dasar

Hanya berlaku untuk penyedia parallel berbayar; parallel-free selalu menggunakan https://search.parallel.ai/mcp dan mengabaikan pengaturan ini. Atur plugins.entries.parallel.config.webSearch.baseUrl untuk mengarahkan permintaan berbayar melalui proksi yang kompatibel atau titik akhir alternatif (misalnya, Cloudflare AI Gateway). OpenClaw menormalkan host tanpa skema dengan menambahkan https:// di awal dan menambahkan /v1/search kecuali jalurnya sudah berakhir demikian. Titik akhir yang dihasilkan menjadi bagian dari kunci tembolok pencarian, sehingga hasil dari titik akhir yang berbeda tidak pernah dibagikan.

​
Parameter alat

Kedua penyedia mengekspos bentuk pencarian native Parallel agar model mengisi tujuan dalam bahasa alami beserta beberapa kueri kata kunci singkat — pasangan yang direkomendasikan Parallel untuk hasil terbaik.
​
string
wajib
Deskripsi dalam bahasa alami mengenai pertanyaan atau tujuan yang mendasarinya (maks. 5000 karakter). Harus dapat dipahami secara mandiri.
​
string[]
wajib
Kueri pencarian kata kunci yang ringkas, masing-masing 3-6 kata (1-5 entri, maks. 200 karakter per entri). Berikan 2-3 kueri yang beragam untuk hasil terbaik.
​
number
Jumlah hasil yang dikembalikan (1-40).
​
string
ID sesi Parallel opsional dari sessionId hasil sebelumnya. Teruskan pada pencarian lanjutan dalam tugas yang sama agar Parallel mengelompokkan panggilan terkait dan meningkatkan hasil berikutnya. Maks. 1000 karakter pada parallel; Search MCP gratis parallel-free membatasinya hingga 100. ID yang melampaui batas akan dibuang (berbayar) atau dibuatkan yang baru (gratis).
​
string
Pengidentifikasi opsional untuk model yang melakukan panggilan (misalnya claude-opus-4-7, gpt-5.6-sol), maks. 100 karakter. Memungkinkan Parallel menyesuaikan pengaturan default dengan kemampuan model Anda. Teruskan slug model aktif yang persis; jangan memendekkannya menjadi alias keluarga.

​
Catatan

  • Parallel memberi peringkat dan memampatkan hasil untuk kegunaan penalaran LLM, bukan untuk klik-tayang manusia; hasilnya berupa kutipan padat per hasil, bukan konten halaman penuh.
  • Kutipan hasil dikembalikan sebagai larik excerpts dan juga digabungkan ke dalam description untuk kompatibilitas dengan kontrak web_search generik.
  • Kedua penyedia mengembalikan session_id; OpenClaw menampilkannya sebagai sessionId dalam muatan alat agar pemanggil dapat mengelompokkan pencarian lanjutan. ID sesi yang dihasilkan Parallel (yang tidak diberikan oleh pemanggil) dikecualikan dari entri tembolok, karena tugas yang tidak terkait dengan kueri identik tidak boleh mewarisinya.
  • searchId, warnings, dan usage dari Parallel diteruskan jika tersedia.
  • OpenClaw selalu meneruskan jumlah hasil yang telah ditentukan ke Parallel sebagai advanced_settings.max_results (parallel) atau menerapkan count di sisi klien setelah respons berukuran tetap dari Parallel (parallel-free). Argumen count dari pemanggil diprioritaskan, lalu tools.web.search.maxResults, atau jika keduanya tidak ada, nilai default web_search generik OpenClaw (5) — nilai default API Parallel sendiri adalah 10.
  • Hasil disimpan dalam tembolok selama 15 menit secara default (cacheTtlMinutes).
  • parallel-free membuat session_id baru untuk setiap panggilan melalui jabat tangan MCP ketika pemanggil tidak memberikannya; dalam kasus tersebut, parallel membiarkannya tidak diatur.

​
Terkait