什么是 私有网络搜索 (SearXNG)？

此技能将强大的聚合搜索引擎 SearXNG 集成到您的 AI 智能体环境中。通过托管您自己的搜索实例，您可以绕过对昂贵的第三方搜索 API 的需求，同时保持完全的隐私和数据主权。它聚合了包括 Google、Bing 和 DuckDuckGo 在内的 70 多个搜索引擎的结果，为智能体工作流提供统一的 JSON 接口。

在 Openclaw Skills 生态系统中使用此组件可确保您的搜索查询保持私密，并使您的自动化程序能够抵御外部 API 封锁或跟踪。它专门为需要高性能搜索能力、且不希望承担商业 API 订阅开销或公共搜索引擎隐私担忧的开发人员设计。

下载入口:https://github.com/openclaw/skills/tree/main/skills/adelpro/private-web-search-searchxng

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

私有网络搜索 (SearXNG) 应用场景

• 需要实时网络访问且无需外部 API 密钥的本地 AI 智能体。
• 严禁主要搜索提供商跟踪查询历史的隐私敏感型研究。
• 在标准搜索 API 被屏蔽的受限环境中开发自动化工具。
• 付费 API 成本对于开发者来说过高的大规模搜索任务。

1. 使用 Docker 部署 SearXNG 容器，在您的机器或服务器上建立本地搜索端点。
2. 配置实例以启用 JSON 输出，允许 AI 智能体以编程方式读取原始搜索数据。
3. AI 智能体通过标准化的 HTTP GET 请求向本地 SearXNG 端点发送查询。
4. SearXNG 并行聚合来自全球多个搜索引擎的结果，并将其作为结构化 JSON 数据返回。
5. 智能体使用 jq 或自定义脚本等标准工具解析结果，为任务提取相关信息。

私有网络搜索 (SearXNG) 配置指南

前提条件

确保您的系统中安装了 docker、curl 和 jq。

安装

# 1. 启动 SearXNG 容器
docker run -d --name searxng -p 8080:8080 -e BASE_URL=http://localhost:8080/ searxng/searxng

# 2. 启用 JSON API 格式
docker exec searxng sed -i 's/  formats:/  formats:
    - json/' /etc/searxng/settings.yml
docker restart searxng

# 3. 验证安装
curl -sL "http://localhost:8080/search?q=test&format=json" | jq '.results[0]'

私有网络搜索 (SearXNG) 数据架构与分类体系

该技能利用基于 JSON 的模式进行智能体与搜索引擎之间的通信。搜索结果中返回的关键元数据字段包括：

配置通过 SEARXNG_PORT、SEARXNG_HOST 和 BASE_URL 等环境变量进行管理，以定义 Openclaw Skills 实例如何与服务交互。

name: private-web-search-searchxng
description: Self-hosted private web search using SearXNG. Use when privacy is important, external APIs are blocked, you need search without tracking, or want to avoid paid search APIs.
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["docker", "curl", "jq"] },
        "install":
          [
            {
              "id": "docker",
              "kind": "bin",
              "command": "docker --version",
              "label": "Docker required",
            },
          ],
      },
  }

Private Web Search (SearXNG)

Privacy-respecting, self-hosted metasearch engine for AI agents.

Quick Setup

# 1. Start container
docker run -d --name searxng -p 8080:8080 -e BASE_URL=http://localhost:8080/ searxng/searxng

# 2. Enable JSON API
docker exec searxng sed -i 's/  formats:/  formats:
    - json/' /etc/searxng/settings.yml
docker restart searxng

# 3. Verify
curl -sL "http://localhost:8080/search?q=test&format=json" | jq '.results[0]'

Usage

Basic Search

curl -sL "http://localhost:8080/search?q=YOUR_QUERY&format=json" | jq '.results[:10]'

Using the Helper Script

./scripts/search.sh "openclaw ai" 5

Environment Variables

Available Engines

Google, Bing, DuckDuckGo, Brave, Startpage, Wikipedia, and more.

Management

docker start searxng   # Start
docker stop searxng    # Stop
docker logs searxng    # View logs
docker rm searxng -f   # Remove

Troubleshooting