Perplexity Sonar setup for web_search

Read when…
  • You want to use Perplexity Sonar for web search
  • You need PERPLEXITY_API_KEY or OpenRouter setup

Perplexity 声纳

OpenClaw 可以通过 web_search 工具使用 Perplexity 声纳。您可以通过 Perplexity 的直接 API 或 OpenRouter 进行连接。

API 选项

Perplexity(直接连接)

  • 基础 URL: https://api.perplexity.ai
  • 环境变量: PERPLEXITY_API_KEY

OpenRouter(替代方案)

  • 基础 URL: https://openrouter.ai/api/v1
  • 环境变量: OPENROUTER_API_KEY
  • 支持预付费/加密货币信用额度。

配置示例

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
          model: "perplexity/sonar-pro",
        },
      },
    },
  },
}

从 Brave 切换

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
        },
      },
    },
  },
}

如果同时设置了 PERPLEXITY_API_KEYOPENROUTER_API_KEY,请设置 tools.web.search.perplexity.baseUrl(或 tools.web.search.perplexity.apiKey)以明确区分。

如果未设置基础 URL,OpenClaw 将根据 API 密钥来源选择默认值:

  • PERPLEXITY_API_KEYpplx-... → 直接使用 Perplexity (https://api.perplexity.ai)
  • OPENROUTER_API_KEYsk-or-... → 使用 OpenRouter (https://openrouter.ai/api/v1)
  • 未知密钥格式 → 使用 OpenRouter(安全回退)

模型

  • perplexity/sonar — 快速问答与网络搜索
  • perplexity/sonar-pro(默认)— 多步骤推理 + 网络搜索
  • perplexity/sonar-reasoning-pro — 深度研究

查看 网络搜索工具 以获取完整的 web_search 配置。