Perplexity 検索

OpenClaw は Perplexity Search API を 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 を再起動します。

openclaw plugins install @openclaw/perplexity-pluginopenclaw gateway restart

Perplexity API キーの取得

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

OpenRouter との互換性

すでに OpenRouter を Perplexity Sonar に使用している場合は、provider: "perplexity" を維持し、Gateway 環境で OPENROUTER_API_KEY を設定するか、plugins.entries.perplexity.config.webSearch.apiKey に sk-or-... キーを保存します。

省略可能な互換性制御項目：

• plugins.entries.perplexity.config.webSearch.baseUrl
• plugins.entries.perplexity.config.webSearch.model

設定例

ネイティブ Perplexity Search API

{  plugins: {    entries: {      perplexity: {        config: {          webSearch: {            apiKey: "pplx-...",          },        },      },    },  },  tools: {    web: {      search: {        provider: "perplexity",      },    },  },}

OpenRouter / Sonar 互換性

{  plugins: {    entries: {      perplexity: {        config: {          webSearch: {            apiKey: "<openrouter-api-key>",            baseUrl: "https://openrouter.ai/api/v1",            model: "perplexity/sonar-pro",          },        },      },    },  },  tools: {    web: {      search: {        provider: "perplexity",      },    },  },}

キーの設定場所

設定を使用する場合： openclaw configure --section web を実行します。キーは ~/.openclaw/openclaw.json 内の plugins.entries.perplexity.config.webSearch.apiKey に保存されます。このフィールドは SecretRef オブジェクトも受け付けます。

環境変数を使用する場合： Gateway プロセス環境で PERPLEXITY_API_KEY または OPENROUTER_API_KEY を設定します。Gateway をインストールしている場合は、~/.openclaw/.env（またはサービス環境）に配置します。環境変数を参照してください。

provider: "perplexity" が設定されており、Perplexity キーの SecretRef が未解決で、環境変数へのフォールバックもない場合、起動または再読み込みは即座に失敗します。

ツールパラメーター

以下のパラメーターは、ネイティブ Perplexity Search API パスに適用されます。

従来の Sonar/OpenRouter 互換パスの場合：

• query、count、freshness を使用できます。
• ここでの count は互換性のためだけに使用されます。レスポンスは N 件の結果リストではなく、引き続き引用付きの合成回答 1 件です。
• Search API 専用フィルター（country、language、date_after、date_before、domain_filter、max_tokens、max_tokens_per_page）を指定すると、明示的なエラーが返されます。

例：

// 国と言語を指定した検索await web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // 最近の結果（過去 1 週間）await web_search({  query: "AI news",  freshness: "week",}); // 日付範囲検索await web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",}); // ドメインフィルタリング（許可リスト）await web_search({  query: "climate research",  domain_filter: ["nature.com", "science.org", ".edu"],}); // ドメインフィルタリング（拒否リスト - 先頭に - を付加）await web_search({  query: "product reviews",  domain_filter: ["-reddit.com", "-pinterest.com"],}); // より多くのコンテンツを抽出await web_search({  query: "detailed AI research",  max_tokens: 50000,  max_tokens_per_page: 4096,});

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

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

注記

• Perplexity Search API は構造化されたウェブ検索結果（title、url、snippet）を返します。
• OpenRouter、または明示的な plugins.entries.perplexity.config.webSearch.baseUrl / model の設定により、互換性のため Perplexity は Sonar チャット補完に戻ります。
• Sonar/OpenRouter 互換性では、構造化された結果行ではなく、引用付きの合成回答 1 件が返されます。
• 結果はデフォルトで 15 分間キャッシュされます（cacheTtlMinutes で設定可能）。

関連項目