Tools 导读

零配置、免API Key的网页搜索接入

DuckDuckGo 是 OpenClaw 唯一一个无需任何密钥即可使用的 web_search 提供方,配置只需一行命令选 provider。注意这是非官方实验性集成,依赖解析无 JavaScript 的 HTML 页面,可能因验证码或页面改版而中断,生产环境建议换用 Brave Search 等 API 方案。

先讲这一页到底在解决什么

零配置、免API Key的网页搜索接入

DuckDuckGo 是 OpenClaw 唯一一个无需任何密钥即可使用的 web_search 提供方,配置只需一行命令选 provider。注意这是非官方实验性集成,依赖解析无 JavaScript 的 HTML 页面,可能因验证码或页面改版而中断,生产环境建议换用 Brave Search 等 API 方案。

原文共 6 节,先看 Start Here 路径:/tools/duckduckgo-search 查看官方原文

第一站

🔑 先记最轻的一句话:它不用 API key

官方一上来就把重点讲完了。DuckDuckGo 最大的好处,就是你不用先去开一堆账号,直接把它设成网页搜索提供商就能开跑。

🆓 不用钥匙

没有 API key 这道门槛。对刚开始搭环境的人来说,这很省事。

🧪 但它是实验性的

它不是官方 API,而是抓网页结果。像借用别人家的门口窗户看里面,能看,但不保证永远不变。

⚠️ 会有小波动

Bot challenge、HTML 结构变化、临时拦截,这些都可能让它突然不顺手。

⭐ 先记一句

DuckDuckGo 的优点是“零配置”,缺点是“没那么稳”。

第二站

🛠 配置它,其实只是在说“网页搜索先走这条路”

官方的配置块很短,因为它本来就不复杂。你只是在告诉 OpenClaw:这次网页搜索,请用 DuckDuckGo。

openclaw configure --section web

像打开网页搜索的设置抽屉,然后在里面选 DuckDuckGo。

provider: \"duckduckgo\"

像在总搜索台挂牌:“以后网页搜索先按 DuckDuckGo 这条路走。”

region

像告诉它要用哪个地区的搜索习惯。比如美国、英国、德国,看到的结果味道会不一样。

safeSearch

像给搜索结果加一层“别太野”的过滤器。默认是 moderate,也可以更严一点或更放一点。

💡 命令 / 配置怎么理解
  • openclaw configure --section web:像把网页搜索这张桌子打开,准备选供应商。
  • provider: \"duckduckgo\":像把桌上的牌子换成 DuckDuckGo。
  • region: \"us-en\":像告诉它“我现在想看美国英语区的结果”。
  • safeSearch: \"moderate\":像把结果整理得别太吓人。

第三站

🎯 你真正会丢给它的,就是一条搜索问题和一点点口味

DuckDuckGo 的参数很少,这反而好记。它就是个轻量搜索工具,不是重型控制台。

🔍

query

就是你要问的问题。像直接对小望远镜说:“帮我看这个。”

1-10

count

像告诉它一次给你搬几张纸回来。默认 5,最多 10。

🌍

region

像切换搜索的地方口音和排序习惯。

🛡

safeSearch

像给搜索结果加个安全边框。

第四站

⚠️ 这页最重要的提醒,是别把“能用”当成“最适合生产”

官方很直接地说了,DuckDuckGo 更像应急和轻量选择。真要长期稳定做网页搜索,最好还是选更正式的 API 型提供商。

🧪 实验性

它的结果来源会受网页结构变化影响,不像正式 API 那么稳。

🤖 可能遇到 bot challenge

有时候不是你配置错了,而是搜索页临时不让你看。

🚦 自动检测顺序靠后

在自动选 provider 时,DuckDuckGo 排得很后。意思是:如果你已经有更稳的付费 API,它不会抢前面。

🎈 一句话收住

DuckDuckGo 像一把现成的小伞,轻便,但不一定最抗风。

最后总结

把这页压成一句最好记的话

DuckDuckGo 是 OpenClaw 的零钥匙网页搜索入口,适合先跑通和临时用;它轻,但不算最稳。

如果你下一页只想继续看一页,我建议看 /tools/brave-search。它和 DuckDuckGo 的最大区别,就是更像“正式的、有钥匙的搜索台”。