Skip to main content
OpenClaw 支持将 DuckDuckGo 作为免密钥 web_search 提供商。无需 API key 或账号。
DuckDuckGo 是一个实验性的非官方集成，会抓取 DuckDuckGo 的非 JavaScript HTML 搜索页面，而不是官方 API。预计偶尔会因机器人验证页面或 HTML 变更而损坏。

​
设置

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 级别。
region 和 safeSearch 工具参数会按查询覆盖上方的插件配置值。

​
说明

  • 无需 API key —— 选择 DuckDuckGo 作为 web_search 提供商后即可使用。
  • 实验性 —— 抓取 DuckDuckGo 的非 JavaScript HTML 搜索页面，而不是官方 API 或 SDK。结果取决于页面结构，页面结构可能在不通知的情况下变化。
  • 机器人验证风险 —— DuckDuckGo 可能会在高频或自动化使用时提供 CAPTCHA 或阻止请求。
  • 仅支持显式选择 —— OpenClaw 的自动检测只会考虑具备可用凭证的提供商，因此像 DuckDuckGo 这样的免密钥提供商永远不会被自动选择；你必须设置 provider: "duckduckgo"。
  • 未配置时，SafeSearch 默认为 moderate。
生产环境使用时，请考虑 Brave Search（提供免费套餐）或其他 API 支持的提供商。

​
相关