DuckDuckGo 搜索

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

设置¶

DuckDuckGo 永远不会被自动选择，因为自动检测只考虑具有可用凭据的提供商。请显式设置：

1. 安装插件

openclaw plugins install @openclaw/duckduckgo-plugin

安装会自动应用于正在运行的 Gateway；否则将在下次启动时生效。参见应用更改并检查。

2. 配置

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 string (路径) 必填

搜索查询。

count number (路径) 默认：5

返回的结果数量（1-10）。

region string (路径)

DuckDuckGo 区域代码（例如 us-en、uk-en、de-de）。

safeSearch 'strict' | 'moderate' | 'off' (路径) 默认：moderate

SafeSearch 级别。

region 和 safeSearch 工具参数会按查询覆盖上述插件配置值。

说明¶

• 无需 API 密钥 -- 一旦将 DuckDuckGo 选为 web_search 提供商即可工作。
• 实验性 -- 抓取 DuckDuckGo 的非 JavaScript HTML 搜索页面，并非官方 API 或 SDK。结果取决于页面结构，页面结构可能随时变更。
• 机器人验证风险 -- 在高负载或自动化使用时，DuckDuckGo 可能会返回 CAPTCHA 或阻止请求。
• 仅显式选择 -- OpenClaw 的自动检测只考虑具有可用凭据的提供商，因此像 DuckDuckGo 这样无需密钥的提供商永远不会被自动选择；你必须设置 provider: "duckduckgo"。
• 未配置时，SafeSearch 默认为 moderate。

相关¶

• Web Search 概览 -- 所有提供商和自动检测
• Brave Search -- 带免费层级的结构化结果
• Exa Search -- 带内容提取的神经搜索