概述

DuckDuckGo 是 OpenClaw web_search 的免费无 API Key 提供商。通过解析 DuckDuckGo 非 JavaScript 搜索页面获取结果,属于实验性非官方集成。

核心功能

  • 无需 API Key,零配置即可使用
  • 支持地区代码(region,如 us-en、de-de)
  • 支持 SafeSearch 级别(strict/moderate/off)
  • 自动检测优先级:order 100(第一个免费回退提供商)

配置/使用

{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en",
            safeSearch: "moderate",
          },
        },
      },
    },
  },
}

注意事项

  • 实验性:基于 HTML 解析,非官方 API,可能因页面结构变化而失效
  • Bot 挑战风险:高频使用可能触发 CAPTCHA 或被封锁
  • 生产环境建议使用 Brave Search(有免费额度)等 API 提供商
  • SafeSearch 默认为 moderate

相关页面

  • concepts/tool-web — Web 搜索工具总览与提供商对比
  • concepts/tool-brave-search — Brave Search(推荐的免费 API 提供商)
  • concepts/tool-searxng-search — SearXNG(自托管免费搜索)