跳转到内容
OpenClaw Docs

DuckDuckGo 搜索

OpenClaw 支持 DuckDuckGo 作为 免密钥 web_search 提供商。不需要 OpenClaw 密钥或帐户。

设置

Section titled “设置”

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

  1. 配置

    bash openclaw configure --section web # Select "duckduckgo" as the provider

配置

Section titled “配置”
{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}

插件级别的可选区域和 SafeSearch 设置：

{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo region code
            safeSearch: "moderate", // "strict", "moderate", or "off"
          },
        },
      },
    },
  },
}

工具参数

Section titled “工具参数”
搜索查询。 要返回的结果数 (1-10)。 DuckDuckGo 区域代码（例如 `us-en`、`uk-en`、`de-de`）。 安全搜索级别。

Region 和 SafeSearch 也可以在插件配置中设置（见上文）——工具 参数会按查询覆盖配置值。

注意事项

Section titled “注意事项”
  • 无 API 密钥——开箱即用，零配置
  • 实验性——从 DuckDuckGo 的非 JavaScript HTML 搜索页面收集结果，而非官方 API 或 SDK
  • 机器人挑战风险——在频繁或自动使用时，DuckDuckGo 可能会提供 CAPTCHA 验证或阻止请求
  • HTML 解析——结果取决于页面结构，该结构可能会在 无通知的情况下发生变化
  • 自动检测顺序——DuckDuckGo 是自动检测中的第一个免密钥后备 （顺序 100）。已配置密钥的 API 支持的提供商 优先运行，然后是 Ollama Web Search（顺序 110），接着是 SearXNG（顺序 200）
  • 安全搜索默认为中等级别（如果未配置）

相关

Section titled “相关”