SearXNG 网页搜索

OpenClaw 支持 SearXNG 作为自托管、无需 API Key 的 web_search Provider。SearXNG 是一个开源元搜索引擎，聚合 Google、Bing、DuckDuckGo 等多个来源的搜索结果。

优势：

• 免费无限额：无需 API Key 或商业订阅
• 隐私保护 / 内网隔离：搜索请求不出网络边界
• 无地区限制：不受商业搜索 API 的地区封锁影响

快速开始

1. 运行 SearXNG 实例：

docker run -d -p 8888:8080 searxng/searxng

或使用任何已有的 SearXNG 部署。生产环境配置请参考 SearXNG 官方文档。

2. 配置 OpenClaw：

openclaw configure --section web
# 选择 "searxng"

或设置环境变量让自动检测发现：

export SEARXNG_BASE_URL="http://localhost:8888"

配置

{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}

插件级别的详细配置：

{
  plugins: {
    entries: {
      searxng: {
        config: {
          webSearch: {
            baseUrl: "http://localhost:8888",
            categories: "general,news", // 可选
            language: "en", // 可选
          },
        },
      },
    },
  },
}

baseUrl 字段也支持 SecretRef 对象。

传输规则：

• 私有/内网/本地 SearXNG：支持 http://
• 公网 SearXNG：必须使用 https://

环境变量

export SEARXNG_BASE_URL="http://localhost:8888"

设置 SEARXNG_BASE_URL 且未配置其他 Provider 时，自动检测会选择 SearXNG（优先级最低，API Key 认证的 Provider 优先）。

配置参数

字段	说明
baseUrl	SearXNG 实例的 Base URL（必填）
categories	逗号分隔的搜索分类，如 general、news、science
language	结果语言代码，如 en、zh、de

注意事项

• 使用 SearXNG 原生 format=json 端点，不是 HTML 抓取
• 无需 API Key，任何 SearXNG 实例均可开箱即用
• Base URL 必须是合法的 http:// 或 https:// URL；公网主机须用 HTTPS
• 自动检测优先级为 200（最低），API Key 认证 Provider、DuckDuckGo(100)、Ollama(110) 均优先于 SearXNG
• 确保 SearXNG 实例的 settings.yml 中 search.formats 已启用 json 格式

延伸阅读

• 网络搜索总览
• Ollama 网页搜索