Skip to main content
OpenClaw 支持将 DuckDuckGo 作为无需密钥的 web_search 提供商。无需 API 密钥或账号。
DuckDuckGo 是一个实验性、非官方集成，它从 DuckDuckGo 的非 JavaScript 搜索页面抓取结果——而不是官方 API。由于机器人挑战页面或 HTML 变更，可能会偶尔失效。

​
设置

无需 API 密钥——只需将 DuckDuckGo 设为你的提供商：
1

配置

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

​
配置

{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}
用于区域和 SafeSearch 的可选插件级设置： 
{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo 区域代码
            safeSearch: "moderate", // "strict"、"moderate" 或 "off"
          },
        },
      },
    },
  },
}

​
工具参数

​
query
string
required
搜索查询。
​
count
number
default:"5"
返回的结果数量（1–10）。
​
region
string
DuckDuckGo 区域代码（例如 us-en、uk-en、de-de）。
​
safeSearch
'strict' | 'moderate' | 'off'
default:"moderate"
SafeSearch 级别。
区域和 SafeSearch 也可以在插件配置中设置（见上文）——工具参数会按每次查询覆盖配置值。

​
注意事项

  • 无需 API 密钥——开箱即用，零配置
  • 实验性——从 DuckDuckGo 的非 JavaScript HTML 搜索页面收集结果，而不是官方 API 或 SDK
  • 机器人挑战风险——在高频或自动化使用下，DuckDuckGo 可能会返回 CAPTCHA 或阻止请求
  • HTML 解析——结果依赖页面结构，而页面结构可能会在不另行通知的情况下发生变化
  • 自动检测顺序——DuckDuckGo 是自动检测中的首个无需密钥回退方案（顺序 100）。已配置密钥的 API 支持提供商会优先运行，然后是 Ollama Web 搜索（顺序 110），再然后是 SearXNG（顺序 200）
  • SafeSearch 默认为 moderate，如果未进行配置
对于生产环境使用，可考虑 Brave Search（提供免费层级）或其他基于 API 的提供商。

​
相关内容