Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw 支持将 DuckDuckGo 作为无需密钥的 web_search 提供商。无需 API 密钥或账户。
DuckDuckGo 是一个实验性、非官方集成，它从 DuckDuckGo 的非 JavaScript 搜索页面拉取结果，而不是官方 API。可能会 因机器人验证页面或 HTML 变更而偶尔中断。

​
设置

无需 API 密钥，只需将 DuckDuckGo 设置为你的提供商：
1

配置

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
required
搜索查询。
​
count
number
default:"5"
要返回的结果数（1-10）。
​
region
string
DuckDuckGo 区域代码（例如 us-en、uk-en、de-de）。
​
safeSearch
'strict' | 'moderate' | 'off'
default:"moderate"
SafeSearch 级别。
区域和 SafeSearch 也可以在插件配置中设置（见上文），工具 参数会按每个查询覆盖配置值。

​
备注

  • 无需 API 密钥 - 开箱即用，零配置
  • 实验性 - 从 DuckDuckGo 的非 JavaScript HTML 搜索页面收集结果，而不是官方 API 或 SDK
  • 机器人验证风险 - 在高频或自动化使用下，DuckDuckGo 可能会提供 CAPTCHA 或阻止请求
  • HTML 解析 - 结果依赖页面结构，而页面结构可能会在未通知的情况下更改
  • 自动检测顺序 - DuckDuckGo 是第一个无需密钥的回退项 （顺序 100）。已配置密钥的 API 后端提供商会先运行， 然后是 Ollama Web 搜索（顺序 110），再然后是 SearXNG（顺序 200）
  • 未配置时 SafeSearch 默认为 moderate
生产使用时，建议考虑 Brave Search（提供免费层级） 或其他 API 后端提供商。

​
相关