SearXNG 搜索

• 免费且无限制——无需 API key 或商业订阅
• 隐私保护 / 网络隔离——查询绝不会离开你的网络
• 随处可用——不受商业搜索 API 的地域限制

​

设置

openclaw plugins install @openclaw/searxng-plugin

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

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", // 可选
          },
        },
      },
    },
  },
}

​

环境变量

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

​

插件配置参考

​

注意事项

• JSON API——使用 SearXNG 原生的 format=json 端点，而非抓取 HTML
• 图片结果 URL——当 SearXNG 返回直接图片 URL 时，图片类别的结果会包含 img_src
• 无需 API key——可直接用于任何 SearXNG 实例
• 基础 URL 验证——baseUrl 必须是有效的 http:// 或 https:// URL
• 网络防护——http:// 基础 URL 必须指向可信的私有主机或 loopback 主机（公共主机必须使用 https://）；解析到私有/内部地址的 https:// 基础 URL 可获得相同的自托管许可，而解析到公共地址的 https:// 基础 URL 仍会受到严格的 SSRF 防护
• 自动检测顺序——SearXNG 需要已配置的 baseUrl（在已具备所需凭据的提供商中，顺序为 200）。DuckDuckGo 或 Ollama Web 搜索等无需密钥的提供商绝不会通过自动检测隐式胜出； 只有明确选择 provider 时才会启用
• 自托管——你可以控制实例、查询和上游搜索引擎
• 类别未配置时默认为 general
• 类别回退——如果非 general 类别的请求成功但返回零条结果， OpenClaw 会使用 general 对同一查询重试一次，然后才返回空结果集
• 结果缓存——相同的查询（查询文本、数量、类别、语言和基础 URL 均相同） 会在进程内缓存一段较短的 TTL
• 版本要求——该插件声明 minHostVersion: >=2026.6.9

​

相关内容

• Web 搜索概览——所有提供商和自动检测
• DuckDuckGo 搜索——另一个无需密钥的提供商
• Brave 搜索——提供免费层级的结构化结果