DuckDuckGo 搜索

OpenClaw 支持将 DuckDuckGo 作为无需 API Key 的 web_search 提供商，无需账号，开箱即用。

注意： DuckDuckGo 是一个实验性、非官方的集成，通过抓取 DuckDuckGo 非 JavaScript 搜索页面获取结果——并非官方 API。可能因反爬挑战页或 HTML 结构变更而偶发失效。

配置

无需 API Key，只需将 DuckDuckGo 设置为提供商：

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

配置文件

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

区域和安全搜索的插件级可选设置：

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

工具调用参数

参数	说明
query	搜索查询（必填）
count	返回结果数（1-10，默认 5）
region	DuckDuckGo 区域代码（如 us-en、uk-en、de-de）
safeSearch	安全搜索级别：strict、moderate（默认）或 off

区域和安全搜索也可在插件配置中设置（见上文），工具参数会在单次查询中覆盖配置值。

注意事项

• 无需 API Key — 零配置，开箱即用
• 实验性 — 通过抓取 DuckDuckGo 非 JavaScript HTML 搜索页获取结果，并非官方 API 或 SDK
• 反爬风险 — 高频或自动化使用时，DuckDuckGo 可能返回验证码或屏蔽请求
• HTML 解析依赖 — 结果依赖页面结构，页面可能随时变更且不预先通知
• 自动检测优先级最低 — DuckDuckGo 在自动检测中排序为 100（最低），任何配置了 API Key 的后端提供商都会优先被选中
• 默认安全搜索为 moderate — 未配置时默认使用中等安全搜索

提示： 如需生产环境使用，建议考虑 Brave Search（有免费套餐）或其他有 API 支持的提供商。

相关文档

• Web 搜索概览 — 所有提供商与自动检测机制
• Brave Search — 有免费套餐的结构化搜索结果
• Exa Search — 带内容提取的神经网络搜索