SearXNG 搜索

• 免费且无限制 — 无需 API 密钥或商业订阅
• 隐私 / 隔离网络 — 查询绝不会离开你的网络
• 到处可用 — 商业搜索 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 密钥 — 可直接与任何 SearXNG 实例配合使用
• 基础 URL 验证 — baseUrl 必须是有效的 http:// 或 https:// URL
• 网络保护 — http:// 基础 URL 必须指向受信任的私有或回环主机（公网主机必须使用 https://）；解析到私有/内部地址的 https:// 基础 URL 享有相同的自托管许可，而解析到公网的 https:// 基础 URL 则保持严格的 SSRF 保护
• 自动检测顺序 — SearXNG 需要配置 baseUrl（在已具备所需凭据的提供方中排序为 200）。像 DuckDuckGo 或 Ollama Web Search 这类无密钥提供方不会隐式赢得自动检测；它们仅在显式选择 provider 时激活
• 自托管 — 你可以控制实例、查询以及上游搜索引擎
• 类别 在未配置时默认为 general
• 类别回退 — 如果非 general 类别请求成功但返回零结果，OpenClaw 会在返回空结果集之前，使用 general 再重试一次相同查询
• 结果缓存 — 相同的查询（相同的 query、count、categories、language 和 base URL）会在进程内缓存一小段 TTL
• 版本要求 — 该插件声明 minHostVersion: >=2026.6.9

​

相关内容

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