跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 支援 DuckDuckGo 作為免金鑰的 web_search 提供者。不需要 API 金鑰或帳戶。
DuckDuckGo 是一項實驗性、非官方整合，會從 DuckDuckGo 的非 JavaScript 搜尋頁面擷取結果，而不是使用官方 API。可能會因機器人驗證頁面或 HTML 變更而偶爾失效。

​
設定

不需要 API 金鑰，只要將 DuckDuckGo 設為你的提供者：
1

設定

openclaw configure --section web
# Select "duckduckgo" as the provider

​
設定

{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}
Plugin 層級的選用地區與 SafeSearch 設定： 
{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo region code
            safeSearch: "moderate", // "strict", "moderate", or "off"
          },
        },
      },
    },
  },
}

​
工具參數

​
query
string
必填
搜尋查詢。
​
count
number
預設值:"5"
要傳回的結果數量（1-10）。
​
region
string
DuckDuckGo 地區代碼（例如 us-en、uk-en、de-de）。
​
safeSearch
'strict' | 'moderate' | 'off'
預設值:"moderate"
SafeSearch 等級。
地區與 SafeSearch 也可以在 Plugin 設定中設定（見上方）；工具參數會依每次查詢覆寫設定值。

​
注意事項

  • 不需要 API 金鑰 - 開箱即用，零設定
  • 實驗性 - 從 DuckDuckGo 的非 JavaScript HTML 搜尋頁面收集結果，而不是使用官方 API 或 SDK
  • 機器人驗證風險 - 在大量或自動化使用時，DuckDuckGo 可能會提供 CAPTCHA 或封鎖請求
  • HTML 解析 - 結果取決於頁面結構，而頁面結構可能會在未通知的情況下變更
  • 自動偵測順序 - DuckDuckGo 是第一個免金鑰備援選項（順序 100）。已設定金鑰的 API 支援提供者會先執行，接著是 Ollama Web Search（順序 110），再來是 SearXNG（順序 200）
  • 未設定時，SafeSearch 預設為 moderate
若用於生產環境，請考慮 Brave Search（提供免費層級）或其他 API 支援的提供者。

​
相關內容