Providers
Perplexity
Perplexity Plugin は、2 つのトランスポートを持つ web_search プロバイダーを登録します。ネイティブの Perplexity Search API（フィルター付きの構造化された結果）と、Perplexity Sonar チャット補完（直接または OpenRouter 経由で利用する、引用付きの AI 合成回答）です。
| プロパティ | 値 |
|---|---|
| 種類 | 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-pluginopenclaw gateway restartはじめに
API キーを設定する
openclaw configure --section webまたは、キーを直接設定します。
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"Gateway 環境で PERPLEXITY_API_KEY または OPENROUTER_API_KEY として
エクスポートされたキーも使用できます。
検索を開始する
web_search は、そのキーが利用可能な検索認証情報になると Perplexity を
自動検出します。追加の設定は不要です。プロバイダーを明示的に固定するには、
次のように設定します。
openclaw config set tools.web.search.provider perplexity検索モード
Plugin は、次の順序でトランスポートを決定します。
webSearch.baseUrlまたはwebSearch.modelが設定されている場合、キーの種類にかかわらず、常にそのエンドポイントに対する Sonar チャット補完を経由します。- それ以外の場合は、キーの取得元によってエンドポイントが決まります。設定済みキーではプレフィックスによってトランスポートが選択され（設定は環境変数より優先されます）、環境変数のキーでは対応するエンドポイントが直接使用されます。
| キーのプレフィックス | トランスポート | 機能 |
|---|---|---|
pplx- |
ネイティブ Perplexity Search API（https://api.perplexity.ai） |
構造化された結果、ドメイン／言語／日付フィルター |
sk-or- |
OpenRouter（https://openrouter.ai/api/v1）、Sonar モデル |
引用付きの AI 合成回答 |
それ以外のプレフィックスを持つ設定済みキーも、ネイティブの Search API を使用します。
チャット補完経路では、デフォルトで perplexity/sonar-pro モデルが使用されます。
plugins.entries.perplexity.config.webSearch.model で上書きできます。
ネイティブ API のフィルタリング
| フィルター | 説明 | トランスポート |
|---|---|---|
count |
検索ごとの結果数、1～10（デフォルトは 5） | ネイティブのみ |
freshness |
新しさの期間：day、week、month、year |
両方 |
country |
2 文字の国コード（us、de、jp） |
ネイティブのみ |
language |
ISO 639-1 言語コード（en、fr、zh） |
ネイティブのみ |
date_after / date_before |
YYYY-MM-DD 形式の公開日範囲 |
ネイティブのみ |
domain_filter |
最大 20 ドメイン。許可リストまたは - プレフィックス付き拒否リスト。混在は不可 |
ネイティブのみ |
max_tokens / max_tokens_per_page |
全結果を通じたコンテンツ上限／ページごとのコンテンツ上限 | ネイティブのみ |
ネイティブ専用フィルターをチャット補完経路で使用すると、内容を説明するエラーが返されます。
freshness を date_after／date_before と組み合わせることはできません。
高度な設定
デーモンプロセス用の環境変数
OpenRouter プロキシの設定
Perplexity 検索を OpenRouter 経由でルーティングするには、ネイティブの
Perplexity キーの代わりに OPENROUTER_API_KEY（プレフィックスは sk-or-）を
設定します。OpenClaw はキーを検出し、自動的に Sonar トランスポートへ切り替えます。
OpenRouter の課金設定がすでにあり、プロバイダーをそこに集約したい場合に便利です。
