web_search
提供商,它们都从专为 AI 智能体构建的 Web 索引中返回经过排序、针对 LLM 优化的摘录:
将
tools.web.search.provider 设置为 parallel-free 或 parallel,可明确选择
其中一个;两者都不会被自动检测。
直接使用 OpenAI Responses 的模型(
api: "openai-responses",提供商为
openai,使用官方 API 基础 URL)在 tools.web.search.provider 未设置、为空、为 "auto"
或 "openai" 时,会自动使用 OpenAI 托管的原生 Web 搜索,因此默认绕过 Parallel。将
tools.web.search.provider 设置为 parallel-free 或 parallel,可改为通过 Parallel
路由这些模型。参阅 Web 搜索概览。安装插件
API 密钥(付费提供商)
parallel-free 不需要密钥,但仍必须明确选择。付费
parallel 提供商需要 API 密钥:
1
创建账户
在 platform.parallel.ai 注册,并
从仪表板生成 API 密钥。
2
存储密钥
在 Gateway 网关环境中设置
PARALLEL_API_KEY,或通过以下命令配置:配置
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-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会将其保持为未设置状态。
相关内容
- Web 搜索概览 — 所有提供商和自动检测
- Exa 搜索 — 带内容提取的神经搜索
- Perplexity 搜索 — 带域名筛选的结构化结果