本页内容
本页内容
供应商
Perplexity
Perplexity 插件注册具有两种传输的 web_search 提供程序:本机 Perplexity 搜索 API(带过滤器的结构化结果)和 Perplexity 声纳聊天完成,直接或通过 OpenRouter(AI- 与引文)。
| 属性 | 值 |
|---|---|
| 类型 | 网页搜索提供方(不是模型提供方) |
| 认证 | PERPLEXITY_API_KEY(原生)或 OPENROUTER_API_KEY(通过 OpenRouter) |
| 配置路径 | plugins.entries.perplexity.config.webSearch.apiKey |
| 覆盖项 | plugins.entries.perplexity.config.webSearch.baseUrl / .model |
| 获取密钥 | perplexity.ai/settings/api |
安装插件
安装自动应用于正在运行的网关;否则下次启动时生效。请参阅 应用更改并检查 。
入门
设置API密钥
或直接设置密钥:
在 Gateway 环境中导出为 PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY 的密钥也可以使用。
开始搜索
web_search自动检测Perplexity一旦其密钥是可用的搜索凭证;无需进一步设置。要显式固定提供程序:
搜索模式
该插件按以下顺序解析传输方式:
- 已设置
webSearch.baseUrl或webSearch.model:始终通过该端点的 Sonar chat completions 路由,而不管密钥类型如何。 - 否则,由密钥来源决定端点:已配置密钥的前缀决定传输方式(配置优先于环境变量);环境密钥则直接使用其匹配的端点。
| 键前缀 | 传输方式 | 功能 |
|---|---|---|
pplx- |
本机 Perplexity 搜索 API (https://api.perplexity.ai) |
结构化结果,domain/language/date 过滤器 |
sk-or- |
OpenRouter (https://openrouter.ai/api/v1),声纳模型 |
AI-综合答案及引文 |
任何其他前缀的已配置密钥也会使用原生 Search API。chat-completions 路径默认使用 perplexity/sonar-pro 模型;可通过 plugins.entries.perplexity.config.webSearch.model 覆盖。
原生 API 过滤
| 过滤器 | 描述 | 传输方式 |
|---|---|---|
count |
每次搜索的结果,1-10(默认 5);已接受但在聊天完成路径上被忽略 | 两者均可 |
freshness |
新近时间窗口:day、week、month、year |
两者均可 |
country |
2 字母国家代码(us、de、jp) |
仅原生 |
language |
ISO 639-1 语言代码(en、fr、zh) |
仅原生 |
date_after / date_before |
以 YYYY-MM-DD 表示的发布日期范围 |
仅原生 |
domain_filter |
最多 20 个域;允许列表或 -- 前缀拒绝列表,切勿混合 |
仅原生 |
max_tokens / max_tokens_per_page |
所有结果/每页的内容预算; max_tokens 最大 1000000 |
仅原生 |
仅本机过滤器在聊天完成路径上返回描述性错误。 freshness 不能与 date_after/date_before. 组合使用
高级配置
守护进程的环境变量
OpenRouter 代理设置
要通过 OpenRouter 路由 Perplexity 搜索,请设置 OPENROUTER_API_KEY(前缀 sk-or-)而不是本机 Perplexity 密钥。 OpenClaw 检测到钥匙并自动切换到声纳传输。如果您已经设置了 OpenRouter 计费并希望在那里整合提供商,则非常有用。
集成标头
对 Perplexity API (api.perplexity.ai) 的请求将 OpenClaw 与 X-Pplx-Integration: openclaw/<version> 一起识别。通过 OpenRouter 路由的搜索将发送 OpenRouter 的应用属性标头。自定义代理 baseUrl 两者都得不到。