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

Tools

Pencarian paralel

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:

Penyedia id Autentikasi
Pencarian Parallel (Gratis) parallel-free Tidak ada -- Search MCP gratis dari Parallel
Pencarian Parallel parallel PARALLEL_API_KEY -- API Pencarian berbayar, batas laju lebih tinggi dan penyesuaian objektif

Atur tools.web.search.provider ke parallel-free atau parallel untuk memilih salah satunya secara eksplisit; keduanya tidak dideteksi secara otomatis.

Instal Plugin

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

Kunci API (penyedia berbayar)

parallel-free tidak memerlukan kunci, tetapi tetap harus dipilih secara eksplisit. 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-...", // opsional jika PARALLEL_API_KEY telah diatur            baseUrl: "https://api.parallel.ai", // opsional; OpenClaw menambahkan /v1/search          },        },      },    },  },  tools: {    web: {      search: {        // "parallel-free" untuk Search MCP gratis, atau "parallel" untuk        // penyedia berbayar berbasis API yang ditampilkan di sini.        provider: "parallel",      },    },  },}

    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.

    objectivestringrequired

    Deskripsi dalam bahasa alami mengenai pertanyaan atau tujuan yang mendasarinya (maks. 5000 karakter). Harus dapat dipahami secara mandiri.

    search_queriesstring[]required

    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.

    countnumber

    Jumlah hasil yang dikembalikan (1-40).

    session_idstring

    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).

    client_modelstring

    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

    Was this useful?
    On this page

    On this page