Tools

平行搜尋

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，以明確選取其中之一；兩者都不會自動偵測。

安裝外掛

bash

openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

API 金鑰（付費提供者）

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

建立帳戶

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

儲存金鑰

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

bash

openclaw configure --section web

設定

json5

{  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 為取得最佳結果而建議的搭配方式。

objectivestringrequired

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

search_queriesstring[]required

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

countnumber

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

session_idstring

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

client_modelstring

發出呼叫之模型的選用識別碼（例如 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 會使其保持未設定。