> ## 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.

# DuckDuckGo 搜尋

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

<Warning>
  DuckDuckGo 是一項**實驗性、非官方**整合，會擷取 DuckDuckGo 的非 JavaScript HTML 搜尋頁面，而不是官方 API。預期偶爾會因機器人驗證頁面或 HTML 變更而故障。
</Warning>

## 設定

DuckDuckGo 絕不會自動選取，因為自動偵測只會考慮具備可用憑證的提供者。請明確設定：

<Steps>
  <Step title="設定">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    # 選取 "duckduckgo" 作為提供者
    ```
  </Step>
</Steps>

## 設定檔

直接在設定檔中設定提供者：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}
```

區域與 SafeSearch 的選用外掛層級設定：

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo 區域代碼
            safeSearch: "moderate", // "strict"、"moderate" 或 "off"
          },
        },
      },
    },
  },
}
```

## 工具參數

<ParamField path="query" type="string" required>
  搜尋查詢。
</ParamField>

<ParamField path="count" type="number" default="5">
  要傳回的結果數量 (1-10)。
</ParamField>

<ParamField path="region" type="string">
  DuckDuckGo 區域代碼 (例如 `us-en`、`uk-en`、`de-de`)。
</ParamField>

<ParamField path="safeSearch" type="'strict' | 'moderate' | 'off'" default="moderate">
  SafeSearch 等級。
</ParamField>

`region` 和 `safeSearch` 工具參數會依每次查詢覆寫上方的外掛設定值。

## 注意事項

* **不需 API 金鑰** -- 選取 DuckDuckGo 作為 `web_search` 提供者後即可運作。
* **實驗性** -- 擷取 DuckDuckGo 的非 JavaScript HTML 搜尋頁面，而不是官方 API 或 SDK。結果取決於頁面結構，可能在未通知的情況下變更。
* **機器人驗證風險** -- DuckDuckGo 可能會在大量或自動化使用時提供 CAPTCHA 或封鎖要求。
* **僅限明確選取** -- OpenClaw 的自動偵測只會考慮具備可用憑證的提供者，因此像 DuckDuckGo 這類免金鑰提供者絕不會自動選擇；你必須設定 `provider: "duckduckgo"`。
* **未設定時，SafeSearch 預設為 `moderate`**。

<Tip>
  若用於正式環境，請考慮 [Brave Search](/zh-TW/tools/brave-search)（提供免費方案）或其他 API 支援的提供者。
</Tip>

## 相關

* [網頁搜尋概觀](/zh-TW/tools/web) -- 所有提供者與自動偵測
* [Brave Search](/zh-TW/tools/brave-search) -- 提供免費方案的結構化結果
* [Exa Search](/zh-TW/tools/exa-search) -- 具內容擷取的神經搜尋