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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Perplexity Plugin は、Perplexity Search API または OpenRouter 経由の Perplexity Sonar を通じて Web 検索機能を提供します。
このページは Perplexity provider のセットアップです。Perplexity tool（エージェントでの使用方法）については、Perplexity tool を参照してください。
プロパティ値
種類Web 検索プロバイダー（モデルプロバイダーではありません）
認証PERPLEXITY_API_KEY（直接）または OPENROUTER_API_KEY（OpenRouter 経由）
設定パスplugins.entries.perplexity.config.webSearch.apiKey

​
はじめに

1

API キーを設定する

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

検索を開始する

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

​
検索モード

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

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

フィルタリングオプションは、ネイティブ Perplexity API（pplx- キー）を使用している場合にのみ利用できます。OpenRouter/Sonar 検索はこれらのパラメーターをサポートしていません。
ネイティブ Perplexity API を使用する場合、検索では次のフィルターがサポートされます。
フィルター説明例
国2 文字の国コードus, de, jp
言語ISO 639-1 言語コードen, fr, zh
日付範囲新しさの期間day, week, month, year
ドメインフィルター許可リストまたは拒否リスト（最大 20 ドメイン）example.com
コンテンツ予算レスポンスごと / ページごとのトークン上限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 アカウントを持っていて、複数プロバイダーにまたがる請求を一元化したい場合に便利です。

​
関連

Perplexity 検索ツール

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

設定リファレンス

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