Perplexity
Perplexity 插件注册了一个 web_search provider,支持两种传输方式:原生 Perplexity 搜索 API(带过滤器的结构化结果)和 Perplexity Sonar 聊天补全(直接或通过 OpenRouter,生成带引用的 AI 合成答案)。
Note
本页介绍 Perplexity provider 的设置。关于 Perplexity tool(代理如何使用它),请参阅 Perplexity 搜索。
| 属性 | 值 |
|---|---|
| 类型 | Web 搜索 provider(不是模型 provider) |
| 认证 | PERPLEXITY_API_KEY(原生)或 OPENROUTER_API_KEY(通过 OpenRouter) |
| 配置路径 | plugins.entries.perplexity.config.webSearch.apiKey |
| 覆盖 | plugins.entries.perplexity.config.webSearch.baseUrl / .model |
| 获取密钥 | perplexity.ai/settings/api |
安装插件¶
安装会自动应用到正在运行的 Gateway;否则将在下次启动时生效。请参阅 应用更改并检查。
快速开始¶
1. 设置 API 密钥
或者直接设置密钥:
在 Gateway 环境中以 PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY 导出的密钥同样有效。
2. 开始搜索
一旦 web_search 检测到可用的搜索凭据是 Perplexity 密钥,它就会自动选择 Perplexity;无需额外设置。若要显式指定 provider:
搜索模式¶
插件按以下顺序解析传输方式:
- 设置
webSearch.baseUrl或webSearch.model:始终通过该端点使用 Sonar 聊天补全,无论密钥类型如何。 - 否则,由密钥来源决定端点:已配置密钥的前缀选择传输方式(配置优先于环境变量);环境变量中的密钥则直接使用其对应的端点。
| 密钥前缀 | 传输方式 | 特性 |
|---|---|---|
pplx- |
原生 Perplexity 搜索 API(https://api.perplexity.ai) |
结构化结果、域名/语言/日期过滤器 |
sk-or- |
OpenRouter(https://openrouter.ai/api/v1),Sonar 模型 |
带引用的 AI 合成答案 |
带有任何其他前缀的已配置密钥也使用原生搜索 API。聊天补全路径默认使用 perplexity/sonar-pro 模型;可通过 plugins.entries.perplexity.config.webSearch.model 覆盖。
原生 API 过滤¶
| 过滤器 | 描述 | 传输方式 |
|---|---|---|
count |
每次搜索的结果数,1-10(默认 5);在聊天补全路径上接受但忽略 | 两者 |
freshness |
时效窗口:day、week、month、year |
两者 |
country |
两位国家代码(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 同时使用。
高级配置¶
守护进程的环境变量
Warning
仅在交互式 shell 中导出的密钥对 launchd/systemd Gateway 守护进程不可见,除非显式导入该环境。请在 ~/.openclaw/.env 中或通过 env.shellEnv 设置密钥,以便 Gateway 进程能够读取。完整的优先级顺序请参阅 环境变量。
OpenRouter 代理设置
要通过 OpenRouter 路由 Perplexity 搜索,请设置 OPENROUTER_API_KEY(前缀 sk-or-),而不是原生 Perplexity 密钥。OpenClaw 会自动检测密钥并切换到 Sonar 传输方式。如果你已经配置了 OpenRouter 计费并希望在那里整合 provider,此功能会很有用。
集成标头
发送到 Perplexity API(api.perplexity.ai)的请求会通过 X-Pplx-Integration: openclaw/<version> 识别 OpenClaw。通过 OpenRouter 路由的搜索会改为发送 OpenRouter 的应用归因标头。自定义代理 baseUrl 则两者都不会收到。
相关¶
代理如何调用 Perplexity 搜索并解释结果。
完整配置参考,包括插件条目。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw