Parallel 插件提供了两个 Parallel web_search 提供商，两者都从为 AI 智能体构建的网页索引中返回排序后的、针对 LLM 优化的摘录¶

将 tools.web.search.provider 设置为 parallel-free 或 parallel 即可显式选择其中一个。付费 Parallel 还可以通过其 API 密钥自动检测；Parallel Search（免费）必须显式选择。

安装插件¶

openclaw plugins install @openclaw/parallel-plugin

如果 Gateway 正在运行，安装会自动生效；否则将在下次启动时生效。请参阅 应用更改并检查。

API 密钥（付费提供商）¶

parallel-free 不需要密钥，但仍必须显式选择。付费的 parallel 提供商需要 API 密钥：

1. 创建账户

在 platform.parallel.ai 注册，并从你的控制台生成 API 密钥。

2. 存储密钥

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

openclaw configure --section web

配置¶

{
  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。

Base URL 覆盖¶

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

将 plugins.entries.parallel.config.webSearch.baseUrl 设置为通过兼容代理或替代端点路由付费请求（例如 Cloudflare AI Gateway）。OpenClaw 会通过添加 https:// 前缀来规范化裸主机，并在路径未以 /v1/search 结尾时附加 /v1/search。解析后的端点是搜索缓存键的一部分，因此不同端点的结果永远不会共享。

工具参数¶

两个提供商都暴露 Parallel 的原生搜索结构，让模型填写一个自然语言目标以及几个简短的关键词查询 —— 这是 Parallel 推荐 以获得最佳结果的组合方式。

objective string (path) required

底层问题或目标的自然语言描述（最多 5000 个字符）。应能自包含地说明意图。

search_queries string[] (path) required

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

count number (path)

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

session_id string (path)

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

client_model string (path)

发起调用的模型的可选标识符（例如 claude-opus-4-7、gpt-6-astra），最多 100 个字符。让 Parallel 根据你模型的能力定制默认设置。请传递当前使用的精确模型 slug；不要简化为系列别名。

注意事项¶

• Parallel 对结果进行排序和压缩，以服务于 LLM 推理，而不是人工点击浏览；因此每个结果返回的是密集摘录，而非整页内容。
• 结果摘录以 excerpts 数组形式返回，同时也会合并到 description 中，以兼容通用的 web_search 约定。
• 两个提供商都会返回 session_id；OpenClaw 将其作为 sessionId 暴露在工具负载中，以便调用方对后续搜索进行分组。由 Parallel 生成的会话 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 Search 概述 —— 所有提供商与自动检测
• Exa 搜索 —— 带内容提取的神经搜索
• Perplexity 搜索 —— 带领域过滤的结构化结果