SearXNG 搜索:AI 智能体的私密元搜索 - Openclaw Skills

作者:互联网

2026-03-29

AI教程

什么是 SearXNG 搜索?

SearXNG 搜索是 Openclaw Skills 库中的一个专门工具,旨在为 AI 编程智能体提供尊重隐私的搜索功能。通过直接与本地或自托管的 SearXNG 实例交互,此技能允许用户聚合来自各种搜索引擎的结果,而无需依赖中心化 API 或牺牲数据隐私。

该技能非常适合需要在保持对搜索流量完全控制的同时进行自动化研究的开发人员。作为 Openclaw Skills 生态系统的一部分,它弥补了本地开发环境与网络、新闻动态和媒体平台上海量信息之间的鸿沟。

下载入口:https://github.com/openclaw/skills/tree/main/skills/phucanh08/searxng-1

安装与下载

1. ClawHub CLI

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

npx clawhub@latest install searxng-1

2. 手动安装

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

全局模式 ~/.openclaw/skills/ 工作区 /skills/

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

3. 提示词安装

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

请帮我使用 Clawhub 安装 searxng-1。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

SearXNG 搜索 应用场景

  • 为技术文档和故障排除进行私密网络研究。
  • 自动发现项目所需的图像或视频等媒体资源。
  • 通过特定类别搜索监控时事和新闻更新。
  • 为 AI 工作流检索实时数据,而不会将查询暴露给外部追踪器。
SearXNG 搜索 工作原理
  1. AI 智能体使用“搜索”或“查找信息”等触发词激活技能。
  2. 请求传递给本地脚本,该脚本为 SearXNG API 构建查询。
  3. 技能连接到环境设置中配置的 SEARXNG_URL。
  4. SearXNG 根据指定类别聚合来自多个引擎(如 Google、Bing 或 DuckDuckGo)的结果。
  5. 技能将格式化的结果或原始 JSON 返回给智能体进行进一步处理。

SearXNG 搜索 配置指南

要开始使用 Openclaw Skills 的此组件,请确保您已安装 python3 并且有一个可访问的 SearXNG 实例。

设置所需的环境变量:

export SEARXNG_URL=https://your-searxng-instance.com

或更新您的智能体配置:

{
  "env": {
    "SEARXNG_URL": "https://your-searxng-instance.com"
  }
}

SearXNG 搜索 数据架构与分类体系

该技能返回结构化的搜索数据,可供程序调用或由智能体读取:

属性 描述
标题 搜索结果的标题
URL 指向所发现资源的直接链接
内容 网页内容的摘要片段
引擎 提供结果的源搜索引擎
类别 内容类型(例如:网页、图像、新闻)
name: searxng
description: Privacy-respecting metasearch using your local SearXNG instance. Search the web, images, news, and more without external API dependencies.
author: Avinash Venkatswamy
version: 1.0.1
homepage: https://searxng.org
triggers:
  - "search for"
  - "search web"
  - "find information"
  - "look up"
metadata: {"clawdbot":{"emoji":"??","requires":{"bins":["python3"]},"config":{"env":{"SEARXNG_URL":{"description":"SearXNG instance URL","default":"http://localhost:8080","required":true}}}}}

Search the web using your local SearXNG instance - a privacy-respecting metasearch engine.

Commands

uv run {baseDir}/scripts/searxng.py search "query"              # Top 10 results
uv run {baseDir}/scripts/searxng.py search "query" -n 20        # Top 20 results
uv run {baseDir}/scripts/searxng.py search "query" --format json # JSON output
uv run {baseDir}/scripts/searxng.py search "query" --category images
uv run {baseDir}/scripts/searxng.py search "query" --category news
uv run {baseDir}/scripts/searxng.py search "query" --category videos

Advanced Options

uv run {baseDir}/scripts/searxng.py search "query" --language en
uv run {baseDir}/scripts/searxng.py search "query" --time-range day

Configuration

Required: Set the SEARXNG_URL environment variable to your SearXNG instance:

export SEARXNG_URL=https://your-searxng-instance.com

Or configure in your Clawdbot config:

{
  "env": {
    "SEARXNG_URL": "https://your-searxng-instance.com"
  }
}

Default (if not set): http://localhost:8080

Features

  • ?? Privacy-focused (uses your local instance)
  • ?? Multi-engine aggregation
  • ?? Multiple search categories
  • ?? Rich formatted output
  • ?? Fast JSON mode for programmatic use

API

Uses your local SearXNG JSON API endpoint (no authentication required by default).