web_search 提供商。它返回包含 title、url 和 snippet 字段的结构化结果。
为保持兼容性,OpenClaw 还支持旧版 Perplexity Sonar/OpenRouter 设置。如果你使用 OPENROUTER_API_KEY、在 plugins.entries.perplexity.config.webSearch.apiKey 中使用 sk-or-... 键,或设置 plugins.entries.perplexity.config.webSearch.baseUrl / model,提供商会切换到聊天补全路径,并返回带引用的 AI 综合答案,而不是结构化的 Search API 结果。
安装插件
安装官方插件,然后重启 Gateway 网关:获取 Perplexity API key
- 在 perplexity.ai/settings/api 创建 Perplexity 账户。
- 在控制面板中生成 API key。
- 将该密钥存入配置,或在 Gateway 网关环境中设置
PERPLEXITY_API_KEY。
OpenRouter 兼容性
如果你已在通过 OpenRouter 使用 Perplexity Sonar,请保留provider: "perplexity",并在 Gateway 网关环境中设置 OPENROUTER_API_KEY,或在 plugins.entries.perplexity.config.webSearch.apiKey 中存储 sk-or-... 键。
可选的兼容性控制项:
plugins.entries.perplexity.config.webSearch.baseUrlplugins.entries.perplexity.config.webSearch.model
配置示例
原生 Perplexity Search API
OpenRouter / Sonar 兼容模式
密钥设置位置
**通过配置:**运行openclaw configure --section web。它会将密钥存储在 ~/.openclaw/openclaw.json 的 plugins.entries.perplexity.config.webSearch.apiKey 下。该字段也接受 SecretRef 对象。
**通过环境变量:**在 Gateway 网关进程环境中设置 PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY。对于 Gateway 网关安装,请将其放入 ~/.openclaw/.env(或你的服务环境)中。请参阅环境变量。
如果已配置 provider: "perplexity",且 Perplexity 密钥 SecretRef 无法解析,也没有环境变量回退值,启动或重新加载会立即失败。
工具参数
这些参数适用于原生 Perplexity Search API 路径。string
必填
搜索查询。
number
默认值:"5"
返回的结果数(1-10)。
string
2 位 ISO 国家代码(例如
US、DE)。string
ISO 639-1 语言代码(例如
en、de、fr)。'day' | 'week' | 'month' | 'year'
时间筛选器——
day 表示 24 小时。string
仅返回在此日期之后发布的结果(
YYYY-MM-DD)。string
仅返回在此日期之前发布的结果(
YYYY-MM-DD)。string[]
域名允许列表/拒绝列表数组(最多 20 个)。
number
默认值:"25000"
总内容预算(最大 1000000)。
number
默认值:"2048"
每页 token 上限。
- 接受
query、count和freshness。 count在该路径中仅用于兼容;响应仍是一个带引用的综合答案,而非包含 N 条结果的列表。- 仅限 Search API 的筛选器(
country、language、date_after、date_before、domain_filter、max_tokens、max_tokens_per_page)会返回明确的错误。
域名筛选规则
- 每个筛选器最多可包含 20 个域名。
- 同一请求中不能混用允许列表和拒绝列表条目。
- 拒绝列表条目使用
-前缀(例如["-reddit.com"])。
注意事项
- Perplexity Search API 返回结构化的 Web 搜索结果(
title、url、snippet)。 - 使用 OpenRouter,或显式设置
plugins.entries.perplexity.config.webSearch.baseUrl/model,会使 Perplexity 切换回 Sonar 聊天补全模式以保持兼容性。 - Sonar/OpenRouter 兼容模式返回一个带引用的综合答案,而非结构化结果行。
- 默认情况下,结果会缓存 15 分钟(可通过
cacheTtlMinutes配置)。
相关内容
Web 搜索概览
所有提供商和自动检测规则。
Brave 搜索
支持国家和语言筛选的结构化结果。
Exa 搜索
支持内容提取的神经搜索。
Perplexity Search API 文档
Perplexity Search API 官方快速开始指南和参考文档。