快速开始

Parallel 搜索

Parallel 插件提供两个 Parallel web_search 提供商：

Parallel 搜索（免费） (parallel-free) -- Parallel 的免费搜索 MCP。不需要账号或 API key。当你想使用 Parallel 托管的免 key 搜索路径时，请显式选择它。
Parallel 搜索 (parallel) -- Parallel 的付费搜索 API。需要 PARALLEL_API_KEY，并提供更高的速率限制和目标调优。

两者都会从为 AI 智能体构建的 Web 索引中返回排序后的、面向 LLM 优化的摘录。将 tools.web.search.provider 设置为 parallel-free 或 parallel，即可显式选择其中之一。

安装插件

安装官方插件，然后重启 Gateway 网关：

bash

openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

API key（付费提供商）

parallel-free 不需要 API key，但仍必须作为托管提供商被选中。付费的 parallel 提供商需要 API key：

创建账号

在 platform.parallel.ai 注册，并从你的仪表板生成 API key。

存储 key

在 Gateway 网关环境中设置 PARALLEL_API_KEY，或通过以下方式配置：

bash

openclaw configure --section web

配置

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

**环境替代方式：**在 Gateway 网关环境中设置 PARALLEL_API_KEY。对于 Gateway 网关安装，请将其放入 ~/.openclaw/.env。

基础 URL 覆盖

基础 URL 覆盖仅适用于付费的 parallel 提供商。免费的 parallel-free 提供商始终使用 https://search.parallel.ai/mcp。

当 Parallel 请求应通过兼容代理或备用 Parallel 端点（例如 Cloudflare AI Gateway）时，设置 plugins.entries.parallel.config.webSearch.baseUrl。OpenClaw 会通过前置 https:// 规范化裸主机，并追加 /v1/search，除非路径已经以它结尾。解析后的端点会包含在搜索缓存键中，因此来自不同 Parallel 端点的结果不会共享。

工具参数

OpenClaw 暴露 Parallel 的原生搜索形状，让模型能够同时填写自然语言目标和几个简短的关键词查询，这是 Parallel 推荐的最佳结果配对方式。

objectivestringrequired

底层问题或目标的自然语言描述（最多 5000 个字符）。应当自包含。

search_queriesstring[]required

简洁的关键词搜索查询，每条 3-6 个词（1-5 条，每条最多 200 个字符）。为获得最佳结果，请提供 2-3 条多样化查询。

countnumber

要返回的结果数（1-40）。

session_idstring

可选的 Parallel 会话 id（parallel 最多 1000 个字符；免费的 parallel-free Search MCP 将其限制为 100 个字符）。对于同一任务的一部分后续搜索，传入上一个 Parallel 结果中的 sessionId，以便 Parallel 可以对相关调用分组并改进后续结果。超过限制的 id 会被丢弃，并生成一个新的 id。

client_modelstring

发起调用的模型的可选标识符（例如 claude-opus-4-7、gpt-5.5）。让 Parallel 能够根据你的模型能力定制默认设置。传入确切的活动模型 slug；不要缩短为系列别名。

说明

Parallel 会根据 LLM 推理效用对结果进行排序和压缩，而不是根据人类点击率；预期每个结果中会有密集摘录，而不是完整页面内容
结果摘录会作为 excerpts 数组返回，也会合并到 description 字段中，以兼容通用 web_search 合约
Parallel 会在每个响应中返回 session_id；OpenClaw 会在工具载荷中将其公开为 sessionId，以便调用方对后续搜索分组
Parallel 返回的 searchId、warnings 和 usage 在存在时会透传
OpenClaw 始终将解析后的结果数作为 advanced_settings.max_results 转发给 Parallel。调用方的 count 参数优先，其次是顶层 tools.web.search.maxResults 设置，否则使用 OpenClaw 的通用 web_search 默认值（5）。这能在切换提供商时保持结果量一致；Parallel 自身默认值为 10
结果默认缓存 15 分钟（可通过 cacheTtlMinutes 配置）
免费的 parallel-free 提供商接受相同参数。它会在客户端应用 count，并在未提供时为每次调用生成一个 session_id。