DuckDuckGo 搜索

DuckDuckGo 搜索

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

DuckDuckGo 是一个 实验性的、非官方的 集成，它从 DuckDuckGo 的 非 JavaScript 搜索页面获取结果 — 而非官方 API。由于机器人验证页面 或 HTML 变更，可能会偶尔出现中断。

设置

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

1. 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），如果未进行配置

对于生产用途，请考虑 Brave 搜索（提供免费层级）或 另一个 API 支持的提供商。

相关

• 网络搜索概述 — 所有提供商和自动检测
• Brave 搜索 — 具有免费层级的结构化结果
• Exa Search —— 带有内容提取功能的神经搜索

---

本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。