Perplexity Sonar を OpenClaw で使う方法

開発をしていると、LLM が最新の情報を知らなくて困ることがあります。ドキュメントを何度も確認したり、手動で検索し直したりするのは手間がかかりますよね。そんな時、信頼できる検索ツールを API 経由で AI に持たせることができれば、作業はずっとスムーズになります。

OpenClaw では、web_search ツールとして Perplexity Sonar を利用できます。Perplexity の直接 API 、または OpenRouter を経由して接続する方法が選べます。

What You’ll Need

• Perplexity API Key (PERPLEXITY_API_KEY)
• または OpenRouter API Key (OPENROUTER_API_KEY)

Quick Start

5 分で完了する最小限の設定手順を紹介します。

設定ファイル（JSON5）の tools セクションに、以下の内容を追加してください。これが最も推奨される構成です。

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
          model: "perplexity/sonar-pro",
        },
      },
    },
  },
}

Brave から切り替える場合は、以下のように記述します。

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
        },
      },
    },
  },
}

利用可能なモデルの選択肢は以下の通りです。

• perplexity/sonar: 高速な Q&A と Web 検索。
• perplexity/sonar-pro: 複数ステップの推論と Web 検索。これがデフォルトです。
• perplexity/sonar-reasoning-pro: 深いリサーチに適したモデル。
• Web tools ドキュメントで、すべての web_search 設定を確認できます。

Troubleshooting

API Key の競合について PERPLEXITY_API_KEY と OPENROUTER_API_KEY の両方が設定されている場合、OpenClaw はどちらを使うべきか判断できません。その場合は、tools.web.search.perplexity.baseUrl または tools.web.search.perplexity.apiKey を明示的に指定して、曖昧さを解消してください。

Base URL の自動判定 Base URL が未設定の場合、OpenClaw は API Key の形式から自動で接続先を選択します。

• PERPLEXITY_API_KEY または pplx-... で始まるキー：直接 Perplexity (https://api.perplexity.ai) に接続します。
• OPENROUTER_API_KEY または sk-or-... で始まるキー：OpenRouter (https://openrouter.ai/api/v1) に接続します。
• 不明なキー形式：安全なフォールバックとして OpenRouter を使用します。
• 明示的な指定：baseUrl を設定することで、これらの自動判定を上書きできます。

設定で分からないことがあれば、AI Setup Assistant で質問してみてください。

What’s Next

• Web tools