给 SearXNG 接入豆包搜索，解决 OpenClaw 信源难题

之前一直有个头疼的问题，就是 OpenClaw 的搜索信源。

它自带的 web_search 就那么几个选择，百度搜出来的质量大家懂的，Google 又被墙了，Bing 勉强能用但偶尔也会抽风。后来我推荐过大家用 SearXNG，自己搭一个聚合搜索引擎，把多个信源揉在一起，这样即使某个挂了还有别的顶着。

但搭完发现 SearXNG 也有它的烦恼——它自己也需要信源啊。而且那些免费的搜索引擎引擎三天两头换接口、加验证，时不时就罢工了。像 startpage 和 duckduckgo 经常被 captcha 拦住，Yandex 搜中文又不太行，稳定可用的信源真的越来越少了。

后来发现火山方舟的 Agent Plan 提供了一个豆包搜索的 Harness，每个月有 500 次免费额度。对个人用户来说完全够用了。而且我本身就开通了方舟的 Agent Plan，用积分（AFP）抵扣就行，搜索一次消耗不了多少积分，很划算。

不过 OpenClaw 原生只给了 skill 和 MCP 的方案来接豆包搜索，对 OpenClaw 本身不太友好。所以我绕了一下，把它接进了 SearXNG，这样 OpenClaw 通过 SearXNG 就能用上豆包搜索了。

折腾完之后觉得这个过程值得记录下来，就写了这篇。

搜索引擎

原理

SearXNG 内置了一个 json_engine，它可以用来对接任意返回 JSON 的搜索 API。我们只需要在配置里定义一个引擎，告诉 SearXNG 请求怎么发、结果怎么解析就行了。

豆包搜索的 API 是一个标准的 HTTP POST 请求，返回 JSON，刚好适配 json_engine。

普通接入方式

如果你没有开通 Agent Plan，也可以用豆包搜索的普通 API。需要先在火山引擎控制台开通豆包模型服务，获取 API Key。

然后编辑 SearXNG 的 settings.yml，在 engines 部分添加：

- name: doubao-search
  engine: json_engine
  search_url: https://open.feedcoopapi.com/search_api/web_search
  method: POST
  request_body: >-
    {{"Query": "{query}", "SearchType": "web", "Count": 10, "NeedSummary": true}}
  results_query: Result/WebResults
  url_query: Url
  title_query: Title
  content_query: Summary
  headers:
    Content-Type: application/json
    Authorization: Bearer YOUR_API_KEY_HERE
    X-Traffic-Tag: skill_web_search_common
  categories:
    - general
  disabled: false

注意 request_body 这里有个坑。json_engine 是用 Python 的 .format() 处理请求体的，所以 JSON 里的大括号必须写成 {{` 和 `}}，不然会被当成 format 的变量名解析，然后报 KeyError。只有 {query} 这种真正的变量才保持单括号。

Agent Plan 接入方式

如果你像我一样开通了方舟的 Agent Plan，那就更简单了。直接用 Agent Plan 的 API Key，配置基本一样，区别在于 API Key 的格式是 ark- 开头的。

把上面的 YOUR_API_KEY_HERE 换成你在 Agent Plan 控制台拿到的 Key 就行。每个月 500 次免费搜索，用完了走积分抵扣，完全不用操心计费的事。

headers:
  Content-Type: application/json
  Authorization: Bearer ark-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx-xxxxx
  X-Traffic-Tag: skill_web_search_common