Skip to main content
Perplexity Plugin は、2 つのトランスポートを持つ web_search プロバイダーを登録します。ネイティブの Perplexity Search API（フィルター付きの構造化された結果）と、直接または OpenRouter 経由で利用する Perplexity Sonar チャット補完（引用付きの AI 合成回答）です。
このページでは、Perplexity プロバイダーの設定について説明します。Perplexity ツール（エージェントがどのように使用するか）については、Perplexity 検索を参照してください。

​
Plugin のインストール

​
はじめに

1

API キーを設定する

または、キーを直接設定します。
Gateway 環境で PERPLEXITY_API_KEY または OPENROUTER_API_KEY としてエクスポートされたキーも使用できます。
2

検索を開始する

web_search は、そのキーが利用可能な検索認証情報になると Perplexity を自動検出します。追加の設定は必要ありません。プロバイダーを明示的に固定するには、次を実行します。

​
検索モード

Plugin は、次の順序でトランスポートを解決します。
  1. webSearch.baseUrl または webSearch.model が設定されている場合：キーの種類に関係なく、常にそのエンドポイントに対する Sonar チャット補完を経由します。
  2. それ以外の場合は、キーの取得元によってエンドポイントが決まります。設定されたキーでは、そのプレフィックスによってトランスポートが選択されます（設定は環境変数より優先されます）。環境変数のキーでは、対応するエンドポイントが直接使用されます。
それ以外のプレフィックスを持つ設定済みキーでも、ネイティブ Search API が使用されます。チャット補完パスでは、デフォルトで perplexity/sonar-pro モデルが使用されます。plugins.entries.perplexity.config.webSearch.model で上書きできます。

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

ネイティブ専用フィルターをチャット補完パスで使用すると、説明付きのエラーが返されます。 freshness は date_after／date_before と組み合わせることはできません。

​
高度な設定

対話型シェルでのみエクスポートされたキーは、その環境を明示的にインポートしない限り、launchd/systemd の Gateway デーモンからは参照できません。Gateway プロセスが読み取れるように、キーを ~/.openclaw/.env に設定するか、env.shellEnv を使用して設定してください。完全な優先順位については、環境変数を参照してください。
Perplexity 検索を OpenRouter 経由でルーティングするには、ネイティブ Perplexity キーの代わりに OPENROUTER_API_KEY（プレフィックスは sk-or-）を設定します。OpenClaw はキーを検出し、自動的に Sonar トランスポートへ切り替えます。すでに OpenRouter の請求設定があり、プロバイダーをそこに集約したい場合に便利です。

​
関連項目

Perplexity 検索ツール

エージェントが Perplexity 検索を呼び出し、結果を解釈する方法です。

設定リファレンス

Plugin エントリを含む完全な設定リファレンスです。