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

DuckDuckGo Search

OpenClaw は DuckDuckGo をAPI キー不要web_search プロバイダーとしてサポートしています。API キーやアカウントは不要です。
DuckDuckGo は、DuckDuckGo の非 JavaScript 検索ページから結果を取得する実験的で非公式な統合です。公式 API ではありません。ボット対策ページや HTML の変更によって、ときどき壊れることがあります。

セットアップ

API キーは不要です。DuckDuckGo をプロバイダーとして設定するだけです。
1

設定

openclaw configure --section web
# プロバイダーとして "duckduckgo" を選択

設定

{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}
リージョンと SafeSearch のオプションのプラグインレベル設定:
{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo のリージョンコード
            safeSearch: "moderate", // "strict"、"moderate"、または "off"
          },
        },
      },
    },
  },
}

ツールパラメーター

Parameter説明
query検索クエリ(必須)
count返す結果数(1〜10、デフォルト: 5)
regionDuckDuckGo のリージョンコード(例: us-enuk-ende-de
safeSearchSafeSearch レベル: strictmoderate(デフォルト)、または off
リージョンと SafeSearch はプラグイン設定でも設定できます(上記参照)。ツール パラメーターは、クエリごとに設定値を上書きします。

メモ

  • API キー不要 — そのまま動作し、設定不要
  • 実験的 — DuckDuckGo の非 JavaScript HTML 検索ページから結果を収集します。公式 API や SDK ではありません
  • ボット対策リスク — DuckDuckGo は、高負荷または自動化された利用時に CAPTCHA を返したり、リクエストをブロックしたりする場合があります
  • HTML パース — 結果はページ構造に依存しており、それは予告なく 変更されることがあります
  • 自動検出順序 — DuckDuckGo は、自動検出における最初の API キー不要フォールバックです (順序 100)。キーが設定された API ベースのプロバイダーが先に実行され、 次に Ollama Web Search(順序 110)、その後に SearXNG(順序 200)が続きます
  • 設定されていない場合、SafeSearch のデフォルトは moderate です
本番利用では、Brave Search(無料枠 あり)や、その他の API ベースのプロバイダーを検討してください。

関連