# DuckDuckGo 搜索

> DuckDuckGo Web 搜索——无需密钥的提供商（实验性，基于 HTML）

- 网址：https://funcoding.ai/agents/openclaw/tools/duckduckgo-search/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/tools/duckduckgo-search

---
OpenClaw 支持将 DuckDuckGo 用作**无需密钥**的 `web_search` 提供商。无需 API 密钥或账户。

<div class="callout callout-warning">

DuckDuckGo 是一项**实验性、非官方**集成，它会抓取 DuckDuckGo 的非 JavaScript HTML 搜索页面，而非使用官方 API。机器人验证页面或 HTML 变更可能会偶尔导致功能失效。

</div>

## 设置

由于自动检测仅考虑具有可用凭据的提供商，因此绝不会自动选择 DuckDuckGo。请明确设置：

**配置**

```bash
openclaw configure --section web
# 选择 "duckduckgo" 作为提供商
```

## 配置

直接在配置中设置提供商：

```json5
{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}
```

可选的插件级区域和 SafeSearch 设置：

```json5
{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo 区域代码
            safeSearch: "moderate", // "strict"、"moderate" 或 "off"
          },
        },
      },
    },
  },
}
```

## 工具参数

搜索查询。

要返回的结果数（1-10）。

DuckDuckGo 区域代码（例如 `us-en`、`uk-en`、`de-de`）。

SafeSearch 级别。

`region` 和 `safeSearch` 工具参数会按查询覆盖上述插件配置值。

## 注意事项

- **无需 API 密钥**——选择 DuckDuckGo 作为 `web_search` 提供商后即可使用。
- **实验性**——抓取 DuckDuckGo 的非 JavaScript HTML 搜索页面，而非使用官方 API 或 SDK。结果取决于页面结构，而页面结构可能随时变更，恕不另行通知。
- **机器人验证风险**——在高频或自动化使用的情况下，DuckDuckGo 可能会提供 CAPTCHA 或阻止请求。
- **只能明确选择**——OpenClaw 的自动检测仅考虑具有可用凭据的提供商，因此绝不会自动选择 DuckDuckGo 这类无需密钥的提供商；你必须设置 `provider: "duckduckgo"`。
- **未配置时，SafeSearch 默认为 `moderate`**。

<div class="callout callout-tip">

对于生产用途，请考虑使用 [Brave Search](https://funcoding.ai/agents/openclaw/tools/brave-search/)（提供免费套餐）或其他基于 API 的提供商。

</div>

## 相关内容

- [Web 搜索概览](https://funcoding.ai/agents/openclaw/tools/web/)——所有提供商和自动检测
- [Brave Search](https://funcoding.ai/agents/openclaw/tools/brave-search/)——提供免费套餐的结构化结果
- [Exa Search](https://funcoding.ai/agents/openclaw/tools/exa-search/)——具有内容提取功能的神经搜索