本页内容

本页内容

供应商

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

安装插件

bash
openclaw plugins install @openclaw/perplexity-plugin

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

入门

  • 设置API密钥

    bash
    openclaw configure --section web

    或直接设置密钥:

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

    在 Gateway 环境中导出为 PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY 的密钥也可以使用。

  • 开始搜索

    web_search自动检测Perplexity一旦其密钥是可用的搜索凭证;无需进一步设置。要显式固定提供程序:

    bash
    openclaw config set tools.web.search.provider perplexity
  • 搜索模式

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

    1. 已设置 webSearch.baseUrl 或 webSearch.model:始终通过该端点的 Sonar chat completions 路由,而不管密钥类型如何。
    2. 否则,由密钥来源决定端点:已配置密钥的前缀决定传输方式(配置优先于环境变量);环境密钥则直接使用其匹配的端点。
    键前缀 传输方式 功能
    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 两者都得不到。

    相关内容

    本页有帮助吗?