Tools

Pencarian paralel

Plugin Parallel menyediakan dua penyedia web_search Parallel:

  • Parallel Search (Free) (parallel-free) -- Search MCP gratis dari Parallel. Tidak memerlukan akun atau kunci API. Pilih secara eksplisit saat Anda menginginkan jalur pencarian tanpa kunci yang dihosting Parallel.
  • Parallel Search (parallel) -- Search API berbayar dari Parallel. Memerlukan PARALLEL_API_KEY dan menawarkan batas laju yang lebih tinggi serta penyetelan objektif.

Keduanya mengembalikan cuplikan berperingkat yang dioptimalkan untuk LLM dari indeks web yang dibuat untuk agen AI. Atur tools.web.search.provider ke parallel-free atau parallel untuk memilih salah satunya secara eksplisit.

Instal Plugin

Instal Plugin resmi, lalu mulai ulang Gateway:

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

Kunci API (penyedia berbayar)

parallel-free tidak memerlukan kunci API, tetapi tetap harus dipilih sebagai penyedia terkelola. Penyedia parallel berbayar memerlukan kunci API:

  • Buat akun

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

  • Simpan kunci

    Atur PARALLEL_API_KEY di lingkungan Gateway, atau konfigurasikan melalui:

    bash
    openclaw configure --section web
  • Konfigurasi

    json5
    {  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",      },    },  },}

    Alternatif lingkungan: atur PARALLEL_API_KEY di lingkungan Gateway. Untuk instalasi gateway, masukkan ke ~/.openclaw/.env.

    Penggantian URL dasar

    Penggantian URL dasar hanya berlaku untuk penyedia parallel berbayar. Penyedia gratis parallel-free selalu menggunakan https://search.parallel.ai/mcp.

    Atur plugins.entries.parallel.config.webSearch.baseUrl saat permintaan Parallel harus melalui proxy yang kompatibel atau endpoint Parallel alternatif (misalnya, Cloudflare AI Gateway). OpenClaw menormalkan host polos dengan menambahkan awalan https:// dan menambahkan /v1/search kecuali path sudah berakhir di sana. Endpoint yang diselesaikan disertakan dalam kunci cache pencarian, sehingga hasil dari endpoint Parallel yang berbeda tidak dibagikan.

    Parameter alat

    OpenClaw mengekspos bentuk pencarian native Parallel sehingga model dapat mengisi baik tujuan bahasa alami maupun beberapa kueri kata kunci pendek — pasangan yang direkomendasikan Parallel untuk hasil terbaik.

    objectivestringrequired

    Deskripsi bahasa alami tentang pertanyaan atau tujuan yang mendasari (maks 5000 karakter). Harus mandiri.

    search_queriesstring[]required

    Kueri pencarian kata kunci yang ringkas, masing-masing 3-6 kata (1-5 entri, maks 200 karakter masing-masing). Berikan 2-3 kueri yang beragam untuk hasil terbaik.

    countnumber

    Hasil yang akan dikembalikan (1-40).

    session_idstring

    ID sesi Parallel opsional (maks 1000 karakter pada parallel; Search MCP gratis parallel-free membatasinya pada 100). Teruskan sessionId dari hasil Parallel sebelumnya pada pencarian lanjutan yang merupakan bagian dari tugas yang sama agar Parallel dapat mengelompokkan panggilan terkait dan meningkatkan hasil berikutnya. ID yang melewati batas dihapus dan yang baru dibuat.

    client_modelstring

    Pengidentifikasi opsional untuk model yang melakukan panggilan (mis. claude-opus-4-7, gpt-5.5). Memungkinkan Parallel menyesuaikan pengaturan default untuk kemampuan model Anda. Teruskan slug model aktif yang persis; jangan mempersingkatnya menjadi alias keluarga.

    Catatan

    • Parallel memberi peringkat dan mengompresi hasil berdasarkan utilitas penalaran LLM, bukan click-through manusia; harapkan cuplikan padat di setiap hasil, bukan konten halaman penuh
    • Cuplikan hasil dikembalikan sebagai array excerpts dan juga digabungkan ke dalam bidang description untuk kompatibilitas dengan kontrak web_search generik
    • Parallel mengembalikan session_id pada setiap respons; OpenClaw mengeksposnya sebagai sessionId dalam payload alat agar pemanggil dapat mengelompokkan pencarian lanjutan
    • searchId, warnings, dan usage dari Parallel diteruskan saat ada
    • OpenClaw selalu meneruskan jumlah hasil yang diselesaikan ke Parallel sebagai advanced_settings.max_results. Arg count pemanggil menang, lalu pengaturan tingkat atas tools.web.search.maxResults, jika tidak default web_search generik OpenClaw (5). Ini menjaga volume hasil tetap konsisten saat beralih antarpenyedia; Parallel sendiri default ke 10
    • Hasil di-cache selama 15 menit secara default (dapat dikonfigurasi melalui cacheTtlMinutes)
    • Penyedia gratis parallel-free menerima parameter yang sama. Penyedia ini menerapkan count di sisi klien dan menghasilkan session_id per panggilan saat tidak disediakan.

    Terkait

    Was this useful?
    On this page

    On this page