A self-hosted search aggregator that enables AI agents to query multiple engines like Google and Bing simultaneously without requiring individual API keys.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install searxng-selfhost
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install searxng-selfhost 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 Search Skill?
The SearXNG skill is a robust solution within the Openclaw Skills ecosystem designed for users who prioritize privacy and autonomy. It acts as a middleware that aggregates results from dozens of search engines—including Google, Bing, Brave, and DuckDuckGo—delivering the data directly to your AI agent in a structured format.
By utilizing this skill, developers can bypass the complexities and costs associated with traditional search engine APIs. It is specifically optimized for agentic workflows, allowing for high-volume research tasks while keeping the search infrastructure entirely under the user's control.
SearXNG Search Skill Use Cases
- Providing AI coding agents with real-time web research capabilities.
- Implementing search functionality in environments where third-party API keys are restricted.
- Conducting private, anonymous searches across multiple engines simultaneously.
- Ensuring search availability through automatic fallback mechanisms to Wikipedia and GitHub APIs.
How SearXNG Search Skill Works
- The user installs the SearXNG service on a Linux VPS or local server using the provided shell script.
- The service creates a dedicated system user and initializes a systemd service running on a local port.
- When a search is required, the search.py tool sends a request to the local SearXNG instance.
- SearXNG queries multiple search engines in parallel and aggregates the findings.
- The tool processes the raw response and returns a clean JSON object or human-readable text.
- In the event of a service interruption, the skill automatically switches to secondary data sources to maintain uptime.
SearXNG Search Skill Setup
To deploy this search capability for your Openclaw Skills instance, execute the installer on Ubuntu 22.04 or 24.04 as root:
bash scripts/install_searxng.sh
Once installed, you can perform searches via the CLI:
python3 scripts/search.py "your search query" --json
To verify that the service is active, use:
systemctl status searxng
SearXNG Search Skill Data Schema & Taxonomy
The skill utilizes a structured configuration and output format to ensure compatibility with AI agents:
| Data Point | Location/Format | Description |
|---|---|---|
| Configuration | /etc/searxng/settings.yml |
Defines enabled engines, ports, and instance behavior. |
| Search Output | JSON Object | Contains arrays of results with title, URL, and content snippets. |
| Connection String | SEARXNG_URL |
The endpoint URL used by the search script to contact the local instance. |
SearXNG Search Skill Advanced Features
- Aggregates results from Google, Bing, Brave, Startpage, DuckDuckGo, and Wikipedia in a single call.
- Zero API key requirement for all supported search engines.
- Built-in failure resistance with automatic fallback to GitHub and Wikipedia APIs.
- Support for custom result counts and machine-parsable JSON flags for automated data extraction.
- Customizable engine blocks to include or exclude specific search providers.
SKILL.md
Loading
Related Openclaw Skills
html2md
An aggressive HTML-to-Markdown converter designed to provide clean, noise-free content for AI agents and research workflows.
Hacker News Poster
A command-line automation skill for submitting stories, replying to comments, and managing profile metadata on Hacker News.
UI/UX Design Pro
A senior-level UI/UX expert for building premium interfaces using the data-driven capabilities of Openclaw Skills.
Tailscale Network Orchestrator
A powerful AI agent integration for managing Tailscale mesh networks and device connectivity through the native CLI.
Copilot Studio Agent Architect
A professional framework for designing, configuring, and deploying autonomous AI agents within the Microsoft Copilot Studio ecosystem.
Crypto Monitor
A powerful command-line utility for real-time cryptocurrency price tracking, whale transaction monitoring, and on-chain data analysis.
Featured*
