Perplexity 搜索提供商

概述

Perplexity Search API 是 OpenClaw web_search 的提供商，返回结构化结果（title、url、snippet）。同时支持 OpenRouter/Sonar 兼容路径（返回 AI 合成答案）。

核心功能

• 原生 Search API：结构化结果，支持国家/语言/时间/域名过滤
• OpenRouter/Sonar 兼容路径：AI 合成答案 + 引用
• 域名过滤：domain_filter 支持最多 20 个域名（allowlist 或 denylist，不可混用）
• 内容预算控制：max_tokens（总量）和 max_tokens_per_page（每页）
• 自动检测优先级：order 50

配置/使用

原生 Search API：

{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: { apiKey: "pplx-..." },
        },
      },
    },
  },
  tools: {
    web: {
      search: { provider: "perplexity" },
    },
  },
}

OpenRouter 兼容：

{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "<openrouter-api-key>",
            baseUrl: "https://openrouter.ai/api/v1",
            model: "perplexity/sonar-pro",
          },
        },
      },
    },
  },
}

环境变量：PERPLEXITY_API_KEY 或 OPENROUTER_API_KEY

注意事项

• 域名过滤：allowlist 和 denylist 不可混用；denylist 条目用 - 前缀（如 "-reddit.com"）
• OpenRouter 路径不支持 country、language、date_after、date_before、domain_filter 等 Search API 专属参数
• 配置了 baseUrl/model 或使用 sk-or-... key 时自动切换到 Sonar 兼容路径

相关页面

• concepts/tool-web — Web 搜索工具总览与提供商对比
• concepts/tool-brave-search — Brave Search（支持国家/语言过滤）
• concepts/tool-exa-search — Exa 神经搜索（支持内容提取）