Skip to main content
OpenClaw は Perplexity Search API を web_search プロバイダーとしてサポートしています。この API は、titleurlsnippet フィールドを含む構造化された結果を返します。 互換性のため、OpenClaw は従来の Perplexity Sonar/OpenRouter 設定もサポートしています。OPENROUTER_API_KEYplugins.entries.perplexity.config.webSearch.apiKey 内の sk-or-... キーを使用するか、plugins.entries.perplexity.config.webSearch.baseUrl / model を設定すると、プロバイダーはチャット補完パスに切り替わり、構造化された Search API の結果ではなく、引用付きの AI 合成回答を返します。

Plugin のインストール

公式 Plugin をインストールしてから、Gateway を再起動します。

Perplexity API キーの取得

  1. perplexity.ai/settings/api で Perplexity アカウントを作成します。
  2. ダッシュボードで API キーを生成します。
  3. キーを設定に保存するか、Gateway 環境で PERPLEXITY_API_KEY を設定します。

OpenRouter との互換性

Perplexity Sonar に OpenRouter をすでに使用していた場合は、provider: "perplexity" を維持して Gateway 環境で OPENROUTER_API_KEY を設定するか、plugins.entries.perplexity.config.webSearch.apiKeysk-or-... キーを保存します。 オプションの互換性制御:
  • plugins.entries.perplexity.config.webSearch.baseUrl
  • plugins.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 国コード(例:USDE)。
string
ISO 639-1 言語コード(例:endefr)。
'day' | 'week' | 'month' | 'year'
期間フィルター。day は 24 時間です。
string
この日付(YYYY-MM-DD)より後に公開された結果のみ。
string
この日付(YYYY-MM-DD)より前に公開された結果のみ。
string[]
ドメインの許可リストまたは拒否リストの配列(最大 20)。
number
デフォルト:"25000"
コンテンツの合計割り当て量(最大 1000000)。
number
デフォルト:"2048"
ページごとのトークン上限。
従来の Sonar/OpenRouter 互換パスの場合:
  • querycountfreshness が受け入れられます。
  • そのパスでは count は互換性のためだけに使用されます。応答は N 件の結果リストではなく、引き続き引用付きの単一の合成回答です。
  • Search API 専用フィルター(countrylanguagedate_afterdate_beforedomain_filtermax_tokensmax_tokens_per_page)を使用すると、明示的なエラーが返されます。
例:

ドメインフィルターのルール

  • フィルターごとに最大 20 ドメイン。
  • 同じリクエスト内で許可リストと拒否リストのエントリを混在させることはできません。
  • 拒否リストのエントリには - プレフィックスを使用します(例:["-reddit.com"])。

注記

  • Perplexity Search API は、構造化された Web 検索結果(titleurlsnippet)を返します。
  • OpenRouter、または明示的な plugins.entries.perplexity.config.webSearch.baseUrl / model を使用すると、互換性のため Perplexity は Sonar チャット補完に戻ります。
  • Sonar/OpenRouter 互換モードでは、構造化された結果行ではなく、引用付きの単一の合成回答が返されます。
  • 結果はデフォルトで 15 分間キャッシュされます(cacheTtlMinutes で設定可能)。

関連項目

Web 検索の概要

すべてのプロバイダーと自動検出ルール。

Brave 検索

国と言語のフィルターを使用した構造化された結果。

Exa 検索

コンテンツ抽出を備えたニューラル検索。

Perplexity Search API ドキュメント

Perplexity Search API の公式クイックスタートとリファレンス。