Providers
Perplexity
Perplexity Plugin は、2 つのトランスポートを持つ web_search プロバイダーを登録します。ネイティブの Perplexity Search API（フィルター付きの構造化された結果）と、直接または OpenRouter 経由で利用する Perplexity Sonar チャット補完（引用付きの 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 回の検索あたりの結果数、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 の請求設定があり、プロバイダーをそこに集約したい場合に便利です。
