web_search プロバイダーとしてサポートしています。この API は、title、url、snippet フィールドを含む構造化された結果を返します。
互換性のため、OpenClaw は従来の Perplexity Sonar/OpenRouter 設定もサポートしています。OPENROUTER_API_KEY、plugins.entries.perplexity.config.webSearch.apiKey 内の sk-or-... キーを使用するか、plugins.entries.perplexity.config.webSearch.baseUrl / model を設定すると、プロバイダーはチャット補完パスに切り替わり、構造化された Search API の結果ではなく、引用付きの AI 合成回答を返します。
Plugin のインストール
公式 Plugin をインストールしてから、Gateway を再起動します。Perplexity API キーの取得
- perplexity.ai/settings/api で Perplexity アカウントを作成します。
- ダッシュボードで API キーを生成します。
- キーを設定に保存するか、Gateway 環境で
PERPLEXITY_API_KEYを設定します。
OpenRouter との互換性
Perplexity Sonar に OpenRouter をすでに使用していた場合は、provider: "perplexity" を維持して Gateway 環境で OPENROUTER_API_KEY を設定するか、plugins.entries.perplexity.config.webSearch.apiKey に sk-or-... キーを保存します。
オプションの互換性制御:
plugins.entries.perplexity.config.webSearch.baseUrlplugins.entries.perplexity.config.webSearch.model
設定例
ネイティブ Perplexity Search API
OpenRouter / Sonar 互換性
キーを設定する場所
設定を使用する場合:openclaw configure --section web を実行します。キーは plugins.entries.perplexity.config.webSearch.apiKey 配下の ~/.openclaw/openclaw.json に保存されます。このフィールドは SecretRef オブジェクトも受け入れます。
環境変数を使用する場合: Gateway プロセス環境で PERPLEXITY_API_KEY または OPENROUTER_API_KEY を設定します。Gateway をインストールしている場合は、~/.openclaw/.env(またはサービス環境)に配置します。環境変数を参照してください。
provider: "perplexity" が設定されており、Perplexity キーの SecretRef を解決できず、環境変数によるフォールバックもない場合、起動または再読み込みは即座に失敗します。
ツールパラメーター
以下のパラメーターは、ネイティブ Perplexity Search API パスに適用されます。string
必須
検索クエリ。
number
デフォルト:"5"
返す結果の数(1~10)。
string
2 文字の ISO 国コード(例:
US、DE)。string
ISO 639-1 言語コード(例:
en、de、fr)。'day' | 'week' | 'month' | 'year'
期間フィルター。
day は 24 時間です。string
この日付(
YYYY-MM-DD)より後に公開された結果のみ。string
この日付(
YYYY-MM-DD)より前に公開された結果のみ。string[]
ドメインの許可リストまたは拒否リストの配列(最大 20)。
number
デフォルト:"25000"
コンテンツの合計割り当て量(最大 1000000)。
number
デフォルト:"2048"
ページごとのトークン上限。
query、count、freshnessが受け入れられます。- そのパスでは
countは互換性のためだけに使用されます。応答は N 件の結果リストではなく、引き続き引用付きの単一の合成回答です。 - Search API 専用フィルター(
country、language、date_after、date_before、domain_filter、max_tokens、max_tokens_per_page)を使用すると、明示的なエラーが返されます。
ドメインフィルターのルール
- フィルターごとに最大 20 ドメイン。
- 同じリクエスト内で許可リストと拒否リストのエントリを混在させることはできません。
- 拒否リストのエントリには
-プレフィックスを使用します(例:["-reddit.com"])。
注記
- Perplexity Search API は、構造化された Web 検索結果(
title、url、snippet)を返します。 - OpenRouter、または明示的な
plugins.entries.perplexity.config.webSearch.baseUrl/modelを使用すると、互換性のため Perplexity は Sonar チャット補完に戻ります。 - Sonar/OpenRouter 互換モードでは、構造化された結果行ではなく、引用付きの単一の合成回答が返されます。
- 結果はデフォルトで 15 分間キャッシュされます(
cacheTtlMinutesで設定可能)。
関連項目
Web 検索の概要
すべてのプロバイダーと自動検出ルール。
Brave 検索
国と言語のフィルターを使用した構造化された結果。
Exa 検索
コンテンツ抽出を備えたニューラル検索。
Perplexity Search API ドキュメント
Perplexity Search API の公式クイックスタートとリファレンス。