内置工具

Parallel 搜索

Parallel 插件提供两个 Parallel web_search 提供商，它们都从专为 AI 智能体构建的 Web 索引中返回经过排序、针对 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-...", // 如果设置了 PARALLEL_API_KEY，则为可选            baseUrl: "https://api.parallel.ai", // 可选；OpenClaw 会附加 /v1/search          },        },      },    },  },  tools: {    web: {      search: {        // 免费 Search MCP 使用 "parallel-free"，此处所示的        // 付费 API 提供商使用 "parallel"。        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

来自先前结果的 sessionId，即可选的 Parallel 会话 ID。在同一任务的后续搜索中传递它，使 Parallel 能将相关调用分组并改善后续结果。 parallel 上限为 1000 个字符；免费的 parallel-free Search MCP 将其限制为 100 个字符。超过限制的 ID 会被丢弃（付费）或重新生成（免费）。

client_modelstring

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

注意事项

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）。
当调用方未提供时，parallel-free 会通过其 MCP 握手为每次调用生成新的 session_id；在这种情况下，parallel 会将其保持为未设置状态。