メインコンテンツへスキップ
Perplexity Plugin は、2 つのトランスポートを持つ web_search プロバイダーを登録します: ネイティブの Perplexity Search API（フィルター付きの構造化された結果）と Perplexity Sonar chat completions（直接、または OpenRouter 経由。引用付きの AI 合成回答）。
このページでは Perplexity プロバイダー の設定について説明します。Perplexity ツール（エージェントがそれをどう使うか）については、Perplexity 検索を参照してください。
プロパティ値
種類Web 検索プロバイダー（モデルプロバイダーではありません）
認証PERPLEXITY_API_KEY（ネイティブ）または OPENROUTER_API_KEY（OpenRouter 経由）
設定パスplugins.entries.perplexity.config.webSearch.apiKey
オーバーライドplugins.entries.perplexity.config.webSearch.baseUrl / .model
キーを取得perplexity.ai/settings/api

​
Plugin をインストール

openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​
はじめに

1

API キーを設定

openclaw configure --section web
または、キーを直接設定します:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
Gateway 環境で PERPLEXITY_API_KEY または OPENROUTER_API_KEY としてエクスポートされたキーも使用できます。
2

検索を開始

web_search は、そのキーが利用可能な検索認証情報になると Perplexity を自動検出します。追加の設定は不要です。プロバイダーを明示的に固定するには:
openclaw config set tools.web.search.provider perplexity

​
検索モード

Plugin は次の順序でトランスポートを解決します:
  1. webSearch.baseUrl または webSearch.model が設定されている場合: キーの種類に関係なく、常にそのエンドポイントに対する Sonar chat completions 経由でルーティングします。
  2. それ以外の場合、キーのソースがエンドポイントを決定します: 設定済みキーのプレフィックスがトランスポートを選択します（設定は環境変数より優先されます）。環境キーは対応するエンドポイントを直接使用します。
キープレフィックストランスポート機能
pplx-ネイティブ Perplexity Search API (https://api.perplexity.ai)構造化された結果、ドメイン/言語/日付フィルター
sk-or-OpenRouter (https://openrouter.ai/api/v1)、Sonar モデル引用付きの AI 合成回答
その他のプレフィックスを持つ設定済みキーも、ネイティブ Search API を使用します。 chat-completions パスはデフォルトで perplexity/sonar-pro モデルを使用します。plugins.entries.perplexity.config.webSearch.model でオーバーライドできます。

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

フィルター説明トランスポート
count検索ごとの結果数、1-10（デフォルト 5）ネイティブのみ
freshness新しさの期間: day、week、month、year両方
country2 文字の国コード（us、de、jp）ネイティブのみ
languageISO 639-1 言語コード（en、fr、zh）ネイティブのみ
date_after / date_beforeYYYY-MM-DD 形式の公開日範囲ネイティブのみ
domain_filter最大 20 ドメイン。許可リストまたは - 接頭辞の拒否リストで、混在不可ネイティブのみ
max_tokens / max_tokens_per_pageすべての結果全体 / ページごとのコンテンツ予算ネイティブのみ
ネイティブ専用フィルターは、chat-completions パスでは説明的なエラーを返します。 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 エントリを含む完全な設定リファレンス。