---
read_when:
- 你希望在没有 API key 的情况下使用 Web 搜索
- 你想使用 Parallel 的付费搜索 API
- 你希望获得按 LLM 上下文效率排序的高密度摘录
summary: Parallel 搜索——来自 Web 来源、针对 LLM 优化的高密度摘录
title: Parallel 搜索
x-i18n:
generated_at: "2026-07-11T21:01:39Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: eff693f286015b287bbdacf44f11ff6f07f2f7d2605ef6f09259e7402b40515e
source_path: tools/parallel-search.md
workflow: 16
---
Parallel 插件提供两个 [Parallel](https://parallel.ai/) `web_search` 提供商，它们都会从专为 AI 智能体构建的网页索引中返回经过排序、针对 LLM 优化的摘要：
| 提供商 | id | 身份验证 |
| ----------------------- | --------------- | ------------------------------------------------------------------------------------------ |
| Parallel 搜索（免费） | `parallel-free` | 无——Parallel 的免费 [Search MCP](https://docs.parallel.ai/integrations/mcp/search-mcp) |
| Parallel 搜索 | `parallel` | `PARALLEL_API_KEY`——付费 Search API，具有更高的速率限制并支持目标调优 |
将 `tools.web.search.provider` 设置为 `parallel-free` 或 `parallel` 可显式选择其中一个；系统不会自动检测它们。
当 `tools.web.search.provider` 未设置、为空、设为 `"auto"` 或设为
`"openai"` 时，直接使用 OpenAI Responses 的模型（`api: "openai-responses"`、
提供商为 `openai`、使用官方 API 基础 URL）会自动使用 OpenAI 托管的原生网页搜索，
因此默认会绕过 Parallel。将 `tools.web.search.provider` 设置为
`parallel-free` 或 `parallel`，即可改为通过 Parallel 路由这些模型。
请参阅 [Web 搜索概览](/zh-CN/tools/web)。
## 安装插件
```bash
openclaw plugins install @openclaw/parallel-plugin
openclaw gateway restart
```
## API 密钥（付费提供商）
`parallel-free` 不需要密钥，但仍必须显式选择。付费 `parallel` 提供商需要 API 密钥：
在 [platform.parallel.ai](https://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 为获得最佳结果而[推荐](https://docs.parallel.ai/search/best-practices)的组合。
对底层问题或目标的自然语言描述（最多 5000 个字符）。应当自包含。
简洁的关键词搜索查询，每条 3–6 个词（1–5 条，每条最多 200 个字符）。为获得最佳结果，请提供 2–3 条多样化查询。
要返回的结果数（1–40）。
可选的 Parallel 会话 ID，取自先前结果的 `sessionId`。在同一任务的后续搜索中传入该值，以便 Parallel 将相关调用分组并改善后续结果。`parallel` 最多允许 1000 个字符；免费的 `parallel-free` Search MCP 上限为 100 个字符。超过限制的 ID 会被丢弃（付费版）或替换为新生成的 ID（免费版）。
发起调用的模型的可选标识符（例如 `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` 则不设置该值。
## 相关内容
- [Web 搜索概览](/zh-CN/tools/web)——所有提供商和自动检测
- [Exa 搜索](/zh-CN/tools/exa-search)——支持内容提取的神经搜索
- [Perplexity 搜索](/zh-CN/tools/perplexity-search)——支持域名筛选的结构化结果