---
read_when:
    - 你想将 Perplexity 配置为 Web 搜索提供商
    - 你需要设置 Perplexity API 密钥或 OpenRouter 代理配置
summary: Perplexity Web 搜索提供商设置（API 密钥、搜索模式、过滤）
title: Perplexity
x-i18n:
    generated_at: "2026-04-12T10:43:01Z"
    model: gpt-5.4
    provider: openai
    source_hash: 55c089e96601ebe05480d305364272c7f0ac721caa79746297c73002a9f20f55
    source_path: providers/perplexity-provider.md
    workflow: 15
---

# Perplexity（Web 搜索提供商）

Perplexity 插件通过 Perplexity Search API 或经由 OpenRouter 的 Perplexity Sonar 提供 Web 搜索能力。

<Note>
本页介绍 Perplexity **提供商** 的设置。关于 Perplexity **工具**（即智能体如何使用它），请参阅 [Perplexity 工具](/zh-CN/tools/perplexity-search)。
</Note>

| 属性 | 值 |
| ----------- | ---------------------------------------------------------------------- |
| 类型 | Web 搜索提供商（不是模型提供商） |
| 凭证 | `PERPLEXITY_API_KEY`（直连）或 `OPENROUTER_API_KEY`（通过 OpenRouter） |
| 配置路径 | `plugins.entries.perplexity.config.webSearch.apiKey` |

## 入门指南

<Steps>
  <Step title="设置 API 密钥">
    运行交互式 Web 搜索配置流程：

    ```bash
    openclaw configure --section web
    ```

    或直接设置密钥：

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

  </Step>
  <Step title="开始搜索">
    配置好密钥后，智能体会自动使用 Perplexity 执行 Web 搜索。无需其他额外步骤。
  </Step>
</Steps>

## 搜索模式

该插件会根据 API 密钥前缀自动选择传输方式：

<Tabs>
  <Tab title="原生 Perplexity API（pplx-）">
    当你的密钥以 `pplx-` 开头时，OpenClaw 会使用原生 Perplexity Search API。此传输方式会返回结构化结果，并支持域名、语言和日期过滤（见下方过滤选项）。
  </Tab>
  <Tab title="OpenRouter / Sonar（sk-or-）">
    当你的密钥以 `sk-or-` 开头时，OpenClaw 会通过 OpenRouter 路由，并使用 Perplexity Sonar 模型。此传输方式会返回带引用的 AI 综合答案。
  </Tab>
</Tabs>

| 密钥前缀 | 传输方式 | 功能 |
| ---------- | ---------------------------- | ------------------------------------------------ |
| `pplx-` | 原生 Perplexity Search API | 结构化结果、域名/语言/日期过滤 |
| `sk-or-` | OpenRouter（Sonar） | 带引用的 AI 综合答案 |

## 原生 API 过滤

<Note>
过滤选项仅在使用原生 Perplexity API 时可用
（`pplx-` 密钥）。OpenRouter/Sonar 搜索不支持这些参数。
</Note>

使用原生 Perplexity API 时，搜索支持以下过滤条件：

| 过滤项 | 说明 | 示例 |
| -------------- | -------------------------------------- | ----------------------------------- |
| 国家 | 2 位国家代码 | `us`, `de`, `jp` |
| 语言 | ISO 639-1 语言代码 | `en`, `fr`, `zh` |
| 日期范围 | 时间新近程度窗口 | `day`, `week`, `month`, `year` |
| 域名过滤 | 允许列表或拒绝列表（最多 20 个域名） | `example.com` |
| 内容预算 | 每次响应 / 每页的 token 限制 | `max_tokens`, `max_tokens_per_page` |

## 高级说明

<AccordionGroup>
  <Accordion title="守护进程的环境变量">
    如果 OpenClaw Gateway 网关 以守护进程（launchd/systemd）方式运行，请确保
    `PERPLEXITY_API_KEY` 对该进程可用。

    <Warning>
    如果密钥只设置在 `~/.profile` 中，launchd/systemd
    守护进程将无法看到它，除非显式导入该环境。请在
    `~/.openclaw/.env` 中设置密钥，或通过 `env.shellEnv` 设置，
    以确保 Gateway 网关 进程能够读取它。
    </Warning>

  </Accordion>

  <Accordion title="OpenRouter 代理设置">
    如果你希望通过 OpenRouter 路由 Perplexity 搜索，请设置
    `OPENROUTER_API_KEY`（前缀为 `sk-or-`），而不是原生 Perplexity 密钥。
    OpenClaw 会检测该前缀，并自动切换到 Sonar 传输方式。

    <Tip>
    如果你已经有 OpenRouter 账户，并希望将多个提供商的计费统一管理，OpenRouter 传输方式会很有用。
    </Tip>

  </Accordion>
</AccordionGroup>

## 相关内容

<CardGroup cols={2}>
  <Card title="Perplexity 搜索工具" href="/zh-CN/tools/perplexity-search" icon="magnifying-glass">
    了解智能体如何调用 Perplexity 搜索并解释结果。
  </Card>
  <Card title="配置参考" href="/zh-CN/gateway/configuration-reference" icon="gear">
    完整的配置参考，包括插件条目。
  </Card>
</CardGroup>
