SearXNG Web Search for Openclaw

Provides AI agents with private, aggregated web search capabilities via a local SearXNG instance.

zomgirprogrammer
v1.0.0
Feb 17, 2026
0
1.4k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install searxng-web

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-web 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 Web Search?

SearXNG Web Search is a specialized tool designed to empower AI agents with real-time web access while maintaining strict data privacy. It acts as a bridge between the agent and a self-hosted SearXNG instance, allowing for decentralized queries across multiple search engines. By utilizing this integration within Openclaw Skills, developers can ensure that their agents retrieve up-to-date information without exposing search patterns to third-party providers. This skill is particularly useful for privacy-conscious research and automated intelligence gathering where data sovereignty is a priority.

SearXNG Web Search Use Cases

  • Retrieving live documentation or API references during coding sessions.
  • Conducting competitive analysis and market research privately.
  • Automating the gathering of facts and snippets for content generation.
  • Providing AI agents with a secure way to browse search engine results without direct external API dependencies.

How SearXNG Web Search Works

  1. The AI agent triggers the searxng_search function with a search query and an optional count.
  2. The request is proxied through a Node.js script to a local SearXNG service running in a Docker environment.
  3. SearXNG aggregates results from numerous search engines based on the query.
  4. The raw search data is filtered and normalized into a clean JSON format.
  5. The agent receives the structured results, including titles, URLs, and snippets, to complete its reasoning task.

SearXNG Web Search Setup

To use this skill, ensure a SearXNG instance is running and accessible at http://host.docker.internal:8081 with the JSON format enabled. You can test the integration directly within your environment using the following command:

docker exec -it openclaw sh -lc 'node searxng_search.js "AI development" 5'

SearXNG Web Search Data Schema & Taxonomy

The search tool produces a standardized output to ensure compatibility across various Openclaw Skills workflows. The output is structured as follows:

Property Type Description
query string The original search string provided to the tool.
count number The maximum number of results to return.
results array A list of objects containing title, url, snippet, and source.

SearXNG Web Search Advanced Features

  • Local hosting support for 100% data sovereignty and privacy.
  • Configurable result counts to optimize agent token usage and context windows.
  • Automatic JSON normalization for easy parsing by Large Language Models.
  • Seamless compatibility with Docker-based AI agent environments using Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*