Skip to main content
Parallel 插件提供两个 Parallel web_search 提供商,它们都从专为 AI 智能体构建的 Web 索引中返回经过排序、针对 LLM 优化的摘录: tools.web.search.provider 设置为 parallel-freeparallel,可明确选择 其中一个;两者都不会被自动检测。
直接使用 OpenAI Responses 的模型(api: "openai-responses",提供商为 openai,使用官方 API 基础 URL)在 tools.web.search.provider 未设置、为空、为 "auto""openai" 时,会自动使用 OpenAI 托管的原生 Web 搜索,因此默认绕过 Parallel。将 tools.web.search.provider 设置为 parallel-freeparallel,可改为通过 Parallel 路由这些模型。参阅 Web 搜索概览

安装插件

API 密钥(付费提供商)

parallel-free 不需要密钥,但仍必须明确选择。付费 parallel 提供商需要 API 密钥:
1

创建账户

platform.parallel.ai 注册,并 从仪表板生成 API 密钥。
2

存储密钥

在 Gateway 网关环境中设置 PARALLEL_API_KEY,或通过以下命令配置:

配置

**环境变量替代方案:**在 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 为获得 最佳结果而推荐的组合。
string
必填
对底层问题或目标的自然语言描述(最多 5000 个字符)。 应当自包含。
string[]
必填
简洁的关键字搜索查询,每个 3-6 个词(1-5 项,每项最多 200 个字符)。 为获得最佳结果,请提供 2-3 个多样化查询。
number
要返回的结果数(1-40)。
string
来自先前结果的 sessionId,即可选的 Parallel 会话 ID。在同一任务的 后续搜索中传递它,使 Parallel 能将相关调用分组并改善后续结果。 parallel 上限为 1000 个字符;免费的 parallel-free Search MCP 将其限制为 100 个字符。超过限制的 ID 会被丢弃(付费)或重新生成(免费)。
string
发起调用的模型的可选标识符(例如 claude-opus-4-7gpt-5.6-sol),最多 100 个字符。它使 Parallel 能够根据你的模型能力调整默认设置。 请传递当前启用模型的确切 slug,不要缩写为模型系列别名。

注意事项

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

相关内容