SearXNG Connect for Openclaw

A privacy-centric skill for connecting AI agents to self-hosted SearXNG instances for untracked, ad-free web searching.

rdeangel
v1.0.0
Mar 6, 2026
0
874
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install searxng-connect

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install searxng-connect using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is SearXNG Connect?

SearXNG Connect is a privacy-focused integration designed to provide AI agents with comprehensive web access without compromising user data. By utilizing a self-hosted SearXNG instance, this Openclaw Skills entry aggregates results from dozens of search engines while stripping away ads and trackers. It serves as a secure bridge for developers who need real-time information retrieval without relying on proprietary, data-harvesting search APIs. The skill is optimized for speed and privacy, ensuring that your AI workflows remain both anonymous and efficient.

SearXNG Connect Use Cases

  • Conducting market research or news monitoring without being tracked by search providers.
  • Extracting high-quality technical documentation and tutorials from across the web.
  • Gathering image or video assets for media workflows using specialized search categories.
  • Performing deep content analysis by retrieving full-page text for AI processing.

How SearXNG Connect Works

  1. The AI agent analyzes a search query to determine the best parameters, such as category or time range.
  2. The skill executes a Python script via the uv package manager, passing the query and flags as a secure argument list.
  3. The script connects to the self-hosted SearXNG instance defined in the local configuration.
  4. Results are retrieved, filtered, and cached locally for a configurable duration to improve response times.
  5. The processed data is returned to the agent, providing a clean set of search results for further use.

SearXNG Connect Setup

To begin using this skill within your Openclaw Skills environment, ensure you have a running SearXNG instance. Install the uv tool for dependency management:

brew install uv

Next, update your skill-config.json with your instance details:

{
  "default_instance": "https://your-searxng-instance.com/",
  "cache_enabled": true
}

SearXNG Connect Data Schema & Taxonomy

Component Description
Configuration Managed via skill-config.json for instance URLs and rate limits.
Cache Local 1-hour storage of search results to optimize performance.
Metadata Supports BCP-47 language codes and category-specific tags.
Result Output Structured list of URLs, snippets, and optional full-page content.

SearXNG Connect Advanced Features

  • Integrated rate limiting to protect your self-hosted infrastructure from excessive requests.
  • Full content extraction mode for fetching the entire text of search result pages.
  • Multi-engine aggregation across categories like science, files, and social media.
  • Flexible time-range filtering ranging from the last hour to the past year.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*