快速开始

Parallel 搜索

Parallel 插件提供两个 Parallel web_search 提供商，它们都会从专为 AI 智能体构建的网页索引中返回经过排序、针对 LLM 优化的摘要：

提供商	id	身份验证
Parallel 搜索（免费）	`parallel-free`	无——Parallel 的免费 Search MCP
Parallel 搜索	`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 密钥。

存储密钥

在 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: {        // "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

仅适用于付费 parallel 提供商；parallel-free 始终使用 https://search.parallel.ai/mcp，并忽略此设置。

设置 plugins.entries.parallel.config.webSearch.baseUrl，可通过兼容代理或替代端点（例如 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

可选的 Parallel 会话 ID，取自先前结果的 sessionId。在同一任务的后续搜索中传入该值，以便 Parallel 将相关调用分组并改善后续结果。parallel 最多允许 1000 个字符；免费的 parallel-free Search MCP 上限为 100 个字符。超过限制的 ID 会被丢弃（付费版）或替换为新生成的 ID（免费版）。

client_modelstring

发起调用的模型的可选标识符（例如 claude-opus-4-7、gpt-5.6-sol），最多 100 个字符。它使 Parallel 能够根据你的模型能力调整默认设置。请传入当前活动模型的确切标识，不要缩写为模型系列别名。

注意事项

Parallel 按照对 LLM 推理的实用性对结果进行排序和压缩，而非针对人工点击浏览；每个结果会提供信息密集的摘要，而不是完整页面内容。
结果摘要以 excerpts 数组返回，同时也会合并到 description 中，以兼容通用 web_search 契约。
两个提供商都会返回 session_id；OpenClaw 在工具载荷中将其公开为 sessionId，以便调用方对后续搜索进行分组。Parallel 生成的会话 ID（即并非由调用方提供的 ID）不会包含在缓存条目中，因为查询相同但彼此无关的任务不应继承该 ID。
Parallel 返回的 searchId、warnings 和 usage（如果存在）会原样传递。
OpenClaw 始终将解析后的结果数量作为 advanced_settings.max_results 转发给 Parallel（parallel），或在收到 Parallel 的固定大小响应后，在客户端应用 count（parallel-free）。优先使用调用方的 count 参数，其次是 tools.web.search.maxResults，否则使用 OpenClaw 的通用 web_search 默认值（5）——Parallel 自身 API 的默认值为 10。
默认缓存结果 15 分钟（cacheTtlMinutes）。
当调用方未提供 session_id 时，parallel-free 会通过 MCP 握手为每次调用生成新的 session_id；在这种情况下，parallel 则不设置该值。