平行搜尋

Parallel 外掛提供兩個 Parallel web_search 提供者，兩者都會從專為 AI 代理程式建立的網頁索引傳回經過排序、針對 LLM 最佳化的摘錄：

提供者	id	驗證
Parallel Search（免費）	parallel-free	無——Parallel 的免費 Search MCP
Parallel Search	parallel	PARALLEL_API_KEY——付費 Search API，具有更高的速率限制與目標調校功能

將 tools.web.search.provider 設為 parallel-free 或 parallel，以明確選取 其中之一；兩者都不會自動偵測。

直接使用 OpenAI Responses 的模型（api: "openai-responses"、提供者 openai、官方 API 基礎 URL）會在 tools.web.search.provider 未設定、為空值、"auto" 或 "openai" 時，自動使用 OpenAI 託管的原生網頁搜尋， 因此預設會略過 Parallel。若要改為透過 Parallel 路由，請將 tools.web.search.provider 設為 parallel-free 或 parallel。 請參閱網頁搜尋概覽。

​

安裝外掛

openclaw plugins install @openclaw/parallel-plugin
openclaw gateway restart

​

API 金鑰（付費提供者）

parallel-free 不需要金鑰，但仍必須明確選取。付費 parallel 提供者需要 API 金鑰：

1. 建立帳戶

   在 platform.parallel.ai 註冊，並 從你的儀表板產生 API 金鑰。

2. 儲存金鑰

   在閘道環境中設定 PARALLEL_API_KEY，或透過下列指令設定：

   openclaw configure --section web
   

​

設定

{
  plugins: {
    entries: {
      parallel: {
        config: {
          webSearch: {
            apiKey: "par-...", // 若已設定 PARALLEL_API_KEY，則為選用
            baseUrl: "https://api.parallel.ai", // 選用；OpenClaw 會附加 /v1/search
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        // 免費 Search MCP 使用 "parallel-free"，此處所示的
        // 付費 API 支援提供者則使用 "parallel"。
        provider: "parallel",
      },
    },
  },
}

**環境變數替代方式：**在閘道環境中設定 PARALLEL_API_KEY。 若是閘道安裝，請將它放入 ~/.openclaw/.env。

​

基礎 URL 覆寫

僅適用於付費 parallel 提供者；parallel-free 一律使用 https://search.parallel.ai/mcp，並忽略此設定。

設定 plugins.entries.parallel.config.webSearch.baseUrl，以透過相容的 Proxy 或替代端點路由付費 請求（例如 Cloudflare AI Gateway）。OpenClaw 會在裸主機名稱前加上 https:// 以進行正規化，並附加 /v1/search，除非路徑已以該字串結尾。解析後的 端點是搜尋快取鍵的一部分，因此不同端點的結果絕不會共用。

​

工具參數

兩個提供者都公開 Parallel 的原生搜尋格式，讓模型填入 自然語言目標及數個簡短的關鍵字查詢——這是 Parallel 為取得 最佳結果而建議的搭配方式。

objective · string · 必填

基礎問題或目標的自然語言描述（最多 5000 個字元）。內容應可獨立理解。

search_queries · string[] · 必填

簡潔的關鍵字搜尋查詢，每項 3-6 個字詞（1-5 項，每項最多 200 個字元）。 為獲得最佳結果，請提供 2-3 個多樣化的查詢。

count · number

要傳回的結果數（1-40）。

session_id · string

上一個結果之 sessionId 中的選用 Parallel 工作階段 ID。在同一任務的 後續搜尋中傳入此 ID，讓 Parallel 將相關呼叫分組，並改善後續結果。 parallel 的上限為 1000 個字元；免費的 parallel-free Search MCP 將其限制為 100 個字元。超過上限的 ID 會被捨棄 （付費），或改為產生新的 ID（免費）。

client_model · string

發出呼叫之模型的選用識別碼（例如 claude-opus-4-7、 gpt-5.6-sol），最多 100 個字元。讓 Parallel 能依據你的 模型能力調整預設設定。請傳入目前使用中模型的完整 slug；不要縮短為 系列別名。

​

注意事項

• Parallel 會依照對 LLM 推理的實用性來排序並壓縮結果，而非供人類 點閱；每個結果會包含密集的摘錄，而非完整頁面 內容。
• 結果摘錄會以 excerpts 陣列傳回，也會合併至 description，以相容於通用的 web_search 合約。
• 兩個提供者都會傳回 session_id；OpenClaw 會在 工具承載資料中將其公開為 sessionId，讓呼叫端能將後續搜尋分組。由 Parallel 產生的工作階段 ID（並非由呼叫端提供）會從快取項目中排除， 因為查詢相同但互不相關的任務不應繼承該 ID。
• Parallel 傳回的 searchId、warnings 和 usage 會在 存在時原樣傳遞。
• OpenClaw 一律會將解析後的結果數量以 advanced_settings.max_results（parallel）轉送至 Parallel，或在 Parallel 傳回固定大小的回應 （parallel-free）後，於用戶端套用 count。 呼叫端的 count 引數優先，其次為 tools.web.search.maxResults，否則使用 OpenClaw 的通用 web_search 預設值（5）——Parallel 自有 API 的預設值 為 10。
• 結果預設會快取 15 分鐘（cacheTtlMinutes）。
• 當呼叫端未提供時，parallel-free 會透過其 MCP 交握，為每次呼叫 產生新的 session_id；在此情況下，parallel 會使其保持未設定。

​

相關內容

• 網頁搜尋概覽——所有提供者與自動偵測
• Exa 搜尋——具備內容擷取功能的神經搜尋
• Perplexity Search——支援網域篩選的結構化結果