Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/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
# 选择 "duckduckgo" 作为提供程序

​
配置

{
  tools: {
    web: {
      search: {
        provider: "duckduckgo",
      },
    },
  },
}
可选的插件级地区和 SafeSearch 设置： 
{
  plugins: {
    entries: {
      duckduckgo: {
        config: {
          webSearch: {
            region: "us-en", // DuckDuckGo 地区代码
            safeSearch: "moderate", // "strict"、"moderate" 或 "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 Search（顺序 110），再然后是 SearXNG（顺序 200）
  • 未配置时 SafeSearch 默认为 moderate
对于生产环境使用，建议考虑 Brave Search（提供免费层级） 或其他基于 API 的提供程序。

​
相关内容