跳转至

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

安装插件

openclaw plugins install @openclaw/perplexity-plugin

安装会自动应用到正在运行的 Gateway;否则将在下次启动时生效。请参阅 应用更改并检查。

快速开始

1. 设置 API 密钥

openclaw configure --section web

或者直接设置密钥:

openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"

在 Gateway 环境中以 PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY 导出的密钥同样有效。

2. 开始搜索

一旦 web_search 检测到可用的搜索凭据是 Perplexity 密钥,它就会自动选择 Perplexity;无需额外设置。若要显式指定 provider:

openclaw config set tools.web.search.provider perplexity

搜索模式

插件按以下顺序解析传输方式:

  1. 设置 webSearch.baseUrl 或 webSearch.model:始终通过该端点使用 Sonar 聊天补全,无论密钥类型如何。
  2. 否则,由密钥来源决定端点:已配置密钥的前缀选择传输方式(配置优先于环境变量);环境变量中的密钥则直接使用其对应的端点。
密钥前缀 传输方式 特性
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 搜索工具

代理如何调用 Perplexity 搜索并解释结果。

配置参考

完整配置参考,包括插件条目。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw