メインコンテンツへスキップ

Perplexity(Web Search Provider)

Perplexity pluginは、Perplexity Search APIまたはOpenRouter経由のPerplexity Sonarを通じてweb search機能を提供します。
このページではPerplexity provider のセットアップを扱います。Perplexity tool(agentがそれをどう使うか)については、Perplexity tool を参照してください。
  • 種別: web search provider(model providerではありません)
  • Auth: PERPLEXITY_API_KEY(直接)または OPENROUTER_API_KEY(OpenRouter経由)
  • Config path: plugins.entries.perplexity.config.webSearch.apiKey

クイックスタート

  1. API keyを設定します:
openclaw configure --section web
または、直接設定します:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
  1. 設定されていれば、agentはweb search時に自動的にPerplexityを使用します。

検索モード

pluginは、API keyの接頭辞に基づいてtransportを自動選択します:
Key prefixTransportFeatures
pplx-ネイティブPerplexity Search API構造化結果、ドメイン/言語/日付フィルター
sk-or-OpenRouter(Sonar)引用付きのAI合成回答

ネイティブAPIのフィルタリング

ネイティブPerplexity API(pplx- key)を使う場合、検索では次をサポートします:
  • Country: 2文字の国コード
  • Language: ISO 639-1言語コード
  • Date range: day、week、month、year
  • Domain filters: allowlist/denylist(最大20ドメイン)
  • Content budget: max_tokens, max_tokens_per_page

環境に関する注意

Gatewayがdaemon(launchd/systemd)として動作している場合は、 PERPLEXITY_API_KEY がそのprocessから利用可能であることを確認してください(たとえば ~/.openclaw/.env または env.shellEnv 経由)。