SearXNG 是一款免费开源的去中心化元搜索引擎，可聚合 Google、Bing、DuckDuckGo 等70+主流搜索引擎资源。区别于商业化搜索引擎，它最大的核心优势是极致的用户隐私保护：全程不追踪用户搜索行为、不存储用户数据、不会向第三方传输查询内容，支持用户匿名全网检索。
同时 SearXNG 支持完全私有化自托管部署，所有搜索请求、检索数据全部留存本地服务器，彻底摆脱商业搜索 API 的 Key 验证、调用次数限制、数据泄露风险。搭配 OpenClaw AI 代理使用，可以让私有 AI 拥有自主可控、永久免费、无额度限制的联网搜索能力。
一、SearXNG 核心作用
- 极致隐私保护
作为去中心化搜索引擎，SearXNG 不会记录用户IP地址、搜索关键词、浏览点击记录，不会收集用户信息构建用户画像，从根源规避商业搜索引擎的数据采集、算法追踪、内容推送监视问题。
- 多引擎聚合检索
单次查询可同时调取数十个国内外搜索引擎结果，整合不同平台的信息源。有效解决单一搜索引擎内容片面、算法限流、信息屏蔽、结果同质化的问题，获取更全面、客观、完整的网络信息。
- 私有化本地部署
支持独立部署在个人/私有服务器，无需对接任何第三方云端API。所有搜索运算、数据传输、结果存储均在私有环境完成，适配开发者、个人极客、中小企业等高隐私、高数据安全需求场景。
- 无门槛无限调用
市面上 Brave、Tavily 等AI搜索工具均需要专属 API Key，存在免费额度上限、付费涨价、接口封禁等问题。自托管 SearXNG 永久免费、无调用次数限制、无额度上限。
- 高度自定义拓展
用户可自主开启/关闭指定搜索引擎、自定义搜索结果排序规则、修改前端主题样式、配置访问限流、自定义接口返回格式，全方位适配个人工作流与AI代理调用需求。
二、OpenClaw 接入 SearXNG 完整部署教程
- 前置条件
服务器环境
操作系统：Ubuntu 20.04 / 22.04 LTS（稳定兼容，推荐版本） 硬件配置：2核CPU、2GB内存、10GB以上硬盘
必备软件工具
已安装 Docker、Docker Compose、Git
项目环境
已成功部署 OpenClaw v2.6.2 及以上版本
- 部署 SearXNG 服务
步骤1：更新系统并安装依赖工具
bash
sudo apt update sudo apt install -y git docker.io curl
步骤2：开机自启Docker并配置用户权限
bash
sudo systemctl enable docker --now sudo usermod -aG docker $USER
重要：执行完毕后重新登录终端，Docker 用户组权限方可生效，避免后续权限报错
步骤3：安装最新版 Docker Compose
bash
sudo curl -L "github.com/docker/comp… -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose
步骤4：拉取 SearXNG 镜像并创建工作目录
bash
mkdir ~/searxng && cd ~/searxng git clone github.com/searxng/sea… .
步骤5：核心配置（必须全部完成）
1. 自动生成随机安全密钥（必填，规避默认密钥漏洞）
bash
sed -i "s|ultrasecretkey|$(openssl rand -hex 32)|g" searxng/settings.yml
2. 开启JSON接口格式（OpenClaw调用必备） 编辑配置文件 searxng/settings.yml ，找到 search 配置项，新增 json 格式：
yaml
search: formats: - html - json
3. 开放端口映射，允许内网访问 编辑项目根目录 docker-compose.yml ，确认端口配置：
yaml
ports:
- "8080:8080"
步骤6：启动服务并验证部署状态
bash
docker compose up -d docker compose ps
服务启动成功后，浏览器访问 服务器IP:8080 ，可正常打开 SearXNG 搜索页面即代表部署成功。
- OpenClaw 接入 SearXNG 两种方案
方法一：web_fetch 通用工具（推荐、零开发、开箱即用）
无需自定义插件、无需修改源码，直接在 OpenClaw 对话指令中调用本地搜索接口，格式通用、稳定无报错。
调用模板
python
url = 'http://你的服务器IP:8080/search?q=搜索关键词&format=json' print(web_fetch(url=url))
实操示例：搜索最新比特币价格
python
url = 'http://192.168.1.100:8080/search?q=比特币+实时价格&format=json' print(web_fetch(url=url))
方法二：自定义搜索工具（高级用法，专属搜索指令）
适合长期使用，可封装专属搜索函数，让 OpenClaw 自主识别、主动调用私有搜索服务。
1. 编辑 OpenClaw 全局工具配置文件，写入自定义工具配置：
json
{ "tools": { "custom_search": { "type": "function", "function": { "name": "custom_search", "description": "调用本地私有SearXNG服务，全网匿名搜索，无API限制、无数据追踪", "parameters": { "type": "object", "properties": { "query": { "type": "string", "description": "用户需要搜索的关键词" } }, "required": ["query"] } } } } }
2. 基于配置编写对应函数逻辑，实现关键词拼接、接口请求、结果解析，完成工具封装。
-
接口与功能验证
-
终端测试JSON接口可用性
bash
curl "http://你的服务器IP:8080/search?q=test&format=json"
返回结构化JSON数据（标题、链接、摘要）代表接口正常。
- OpenClaw 功能验证
在 OpenClaw 对话框输入指令： 搜索最新的AI技术发展趋势
- 正常返回多源整合的结构化搜索结果
- 无 403、500 报错、无接口超时 即代表接入完全成功。
- 常见报错与解决方案
1. 403 Forbidden 访问拒绝 原因：SearXNG 默认开启访问限流机制 解决：修改 settings.yml ，将 limiter: true 改为 limiter: false ，关闭限流 2. 外网/内网无法访问服务 原因：服务器防火墙未放行端口 解决：放行8080端口，同时可使用Docker内网网关 172.17.0.1 本地访问 3. 插件依赖报错 解决：清理无效本地依赖，删除配置中 link:/home/adam/clawdbot 无效路径 4. 自定义工具无法调用 解决：在 OpenClaw 工具白名单中添加配置： "tools": {"allow": ["web_search_v2","custom_search"]}
三、方案优势与注意事项
核心优势
1. 完全免费无限制：无需申请API Key，永久无调用额度、无付费门槛 2. 数据绝对自主可控：所有搜索请求、数据不经过任何第三方云端，私有化部署保障隐私 3. 高隐私安全性：无用户追踪、无画像收集，满足个人隐私及企业合规需求
注意事项
1. 自主维护成本：需要使用者自行维护服务器、更新镜像、排查服务异常 2. 搜索结果容错：结果质量取决于自行配置的搜索引擎源，略逊于商业付费搜索API 3. 具备基础技术门槛：对比官方商用API一键接入，私有化部署需要基础Linux运维能力
四、总结
将 SearXNG 私有化部署并接入 OpenClaw，是个人AI代理隐私联网的最优方案。彻底解决了商用搜索API收费、限流、数据泄露、第三方监控等痛点，让 OpenClaw 拥有完全自主、匿名、无限次的全网搜索能力，非常适合技术开发者、隐私爱好者、需要私有化AI服务的个人与企业。
