DuckDuckGo 搜索

OpenClaw 支持 DuckDuckGo 作为 免密钥 的 web_search 提供商。无需 API 密钥或账户。

设置

不需要 API 密钥 — 只需将 DuckDuckGo 设置为您的提供商：

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

配置

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

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

{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo region code
            safeSearch: "moderate", // "strict", "moderate", or "off"
          },
        },
      },
    },
  },
}

工具参数

参数	描述
`query`	搜索查询（必填）
`count`	要返回的结果数（1-10，默认：5）
`region`	DuckDuckGo 区域代码（例如 `us-en`, `uk-en`, `de-de`）
`safeSearch`	SafeSearch 等级：`strict`、`moderate`（默认）或 `off`

区域和 SafeSearch 也可以在插件配置中设置（见上文） — 工具参数会逐次查询覆盖配置值。

注意事项

无需 API 密钥 — 开箱即用，零配置
实验性 — 从 DuckDuckGo 的非 JavaScript HTML 搜索页面收集结果，而非官方 API 或 SDK
机器人验证风险 — 在大量或自动使用时，DuckDuckGo 可能会提供 CAPTCHA 或阻止请求
HTML 解析 — 结果取决于页面结构，该结构可能在未通知的情况下发生变化
自动检测顺序 — DuckDuckGo 在自动检测中排在最后（顺序 100），因此任何带有密钥的 API 支持提供商都具有优先权
SafeSearch 默认为适中（moderate），如果未进行配置

DuckDuckGo 搜索

DuckDuckGo 搜索

设置

配置

工具参数

注意事项

相关