跳轉到主要內容
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 支援的提供者。

​
相關