DuckDuckGo 搜尋

OpenClaw 支援 DuckDuckGo 作為免金鑰的 web_search 提供者。不需要 API 金鑰或帳號。

DuckDuckGo 是一項實驗性、非官方整合，會擷取 DuckDuckGo 的非 JavaScript HTML 搜尋頁面，而非使用官方 API。機器人驗證頁面或 HTML 變更偶爾可能導致功能失效。

​

設定

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"
          },
        },
      },
    },
  },
}

​

工具參數

query · string · 必填

搜尋查詢。

count · number · 預設值: "5"

要傳回的結果數量（1-10）。

region · string

DuckDuckGo 區域代碼（例如 us-en、uk-en、de-de）。

safeSearch · 'strict' | 'moderate' | 'off' · 預設值: "moderate"

SafeSearch 等級。

region 和 safeSearch 工具參數會以每次查詢為基礎，覆寫上述外掛組態值。

​

注意事項

• 不需要 API 金鑰——選取 DuckDuckGo 作為 web_search 提供者後即可使用。
• 實驗性——擷取 DuckDuckGo 的非 JavaScript HTML 搜尋頁面，而非使用官方 API 或 SDK。結果取決於頁面結構，而該結構可能隨時變更，恕不另行通知。
• 機器人驗證風險——在大量或自動化使用時，DuckDuckGo 可能會顯示 CAPTCHA 或封鎖請求。
• 僅限明確選取——OpenClaw 的自動偵測只會考慮具有可用認證資訊的提供者，因此 DuckDuckGo 這類免金鑰提供者永遠不會被自動選取；你必須設定 provider: "duckduckgo"。
• 未設定時，SafeSearch 預設為 moderate。

若用於正式環境，請考慮使用 Brave Search（提供免費方案）或其他以 API 為基礎的提供者。

​

相關內容

• 網頁搜尋概覽——所有提供者與自動偵測
• Brave Search——提供免費方案的結構化結果
• Exa Search——具備內容擷取功能的神經搜尋