跳转至

DuckDuckGo 搜索

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

Warning

DuckDuckGo 是一个实验性、非官方集成,它抓取 DuckDuckGo 的非 JavaScript HTML 搜索页面 -- 不是官方 API。可能会因机器人验证页面或 HTML 变更而偶尔失效。

设置

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 (path) 必填
搜索查询。
count number (path) 默认:5
要返回的结果数(1-10)。
region string (path)
DuckDuckGo 区域代码(例如 us-en、uk-en、de-de)。
safeSearch 'strict' | 'moderate' | 'off' (path) 默认:moderate
SafeSearch 级别。

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

备注

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

Tip

用于生产环境时,请考虑 Brave Search(提供免费层级)或其他基于 API 的提供商。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw