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

​
Perplexity（Web 検索 provider）

Perplexity Plugin は、Perplexity Search API または OpenRouter 経由の Perplexity Sonar を通じて Web 検索機能を提供します。
このページでは Perplexity provider のセットアップを扱います。Perplexity tool（エージェントがこれをどう使うか）については、Perplexity tool を参照してください。
PropertyValue
TypeWeb 検索 provider（model provider ではない）
AuthPERPLEXITY_API_KEY（直接）または OPENROUTER_API_KEY（OpenRouter 経由）
Config pathplugins.entries.perplexity.config.webSearch.apiKey

​
はじめに

1

API key を設定

対話型の Web 検索設定フローを実行します。
openclaw configure --section web
または、キーを直接設定します。
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

検索を開始

キーが設定されると、エージェントは Web 検索に自動的に Perplexity を使用します。 追加の手順は不要です。

​
検索モード

Plugin は、API key のプレフィックスに基づいてトランスポートを自動選択します。
キーが pplx- で始まる場合、OpenClaw はネイティブの Perplexity Search API を使用します。このトランスポートは構造化結果を返し、ドメイン、言語、 日付フィルターをサポートします（以下のフィルタリングオプションを参照）。
キーのプレフィックストランスポート機能
pplx-ネイティブ Perplexity Search API構造化結果、ドメイン/言語/日付フィルター
sk-or-OpenRouter（Sonar）引用付きの AI 合成回答

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

フィルタリングオプションは、ネイティブ Perplexity API （pplx- キー）を使う場合にのみ利用できます。OpenRouter/Sonar の検索では、これらのパラメータはサポートされません。
ネイティブ Perplexity API を使う場合、検索は次のフィルターをサポートします。
Filter説明例
Country2 文字の国コードus、de、jp
LanguageISO 639-1 言語コードen、fr、zh
Date range新しさの範囲day、week、month、year
Domain filtersallowlist または denylist（最大 20 ドメイン）example.com
Content budget応答ごと / ページごとのトークン上限max_tokens、max_tokens_per_page

​
高度な注記

OpenClaw Gateway がデーモン（launchd/systemd）として実行される場合は、 PERPLEXITY_API_KEY がそのプロセスで利用可能であることを確認してください。
~/.profile にのみ設定されたキーは、その環境が明示的に取り込まれない限り、 launchd/systemd デーモンからは見えません。Gateway プロセスが 読み取れるようにするには、キーを ~/.openclaw/.env または env.shellEnv に設定してください。
Perplexity 検索を OpenRouter 経由でルーティングしたい場合は、 ネイティブの Perplexity キーの代わりに OPENROUTER_API_KEY（プレフィックス sk-or-）を設定してください。 OpenClaw はプレフィックスを検出し、自動的に Sonar トランスポートへ切り替えます。
OpenRouter トランスポートは、すでに OpenRouter アカウントを持っていて、 複数 provider にまたがる課金を一元化したい場合に便利です。

​
関連

Perplexity 検索 tool

エージェントが Perplexity 検索を呼び出し、結果をどう解釈するか。

設定リファレンス

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