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 Search（顺序 110），再然后是 SearXNG（顺序 200）
  • SafeSearch 默认为 moderate，当未配置时
对于生产环境使用，建议考虑 Brave Search（提供免费层级） 或其他基于 API 的提供程序。

​
相关内容