Search Web (SearXNG) for Openclaw

A privacy-centric tool that connects OpenClaw agents to a local SearXNG instance for real-time web searching.

lokixshrishi
v1.0.0
Mar 7, 2026
0
1.5k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install search-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 search-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 Search Web (SearXNG)?

The Search Web skill is a specialized integration designed to provide Openclaw Skills with real-time access to the internet without compromising privacy. By connecting to a self-hosted SearXNG instance, this tool allows an agent to bypass the limitations of static training data and retrieve the most current information available online. It is particularly valuable for developers and researchers who require a secure, local-first approach to web data retrieval.

This skill acts as a bridge between the AI agent and the SearXNG HTTP API, ensuring that every search query is handled through your own infrastructure. This architecture supports a wide range of Openclaw Skills by providing structured JSON results that the agent can immediately analyze, summarize, or use for further automated tasks.

Search Web (SearXNG) Use Cases

  • Fetching the latest news or documentation for rapidly evolving technologies.
  • Verifying facts and cross-referencing information from multiple external web sources.
  • Gathering specific URLs and research papers for deep-dive technical analysis.
  • Retrieving current data on specialized topics such as blockchain, AI developments, or cybersecurity threats.

How Search Web (SearXNG) Works

  1. The AI agent determines that a query requires external web data to provide an accurate response.
  2. The agent invokes the Search Web tool with a specific string as the query parameter.
  3. The skill sends an HTTP request to the configured SearXNG search endpoint (defaulting to localhost:8080).
  4. SearXNG aggregates results from various search engines and returns them in a structured format.
  5. The skill processes the JSON response, extracting titles and URLs, and returns this list to the Openclaw Skills environment for processing.

Search Web (SearXNG) Setup

To use this skill, you must have a running instance of SearXNG accessible to your agent. Ensure that the JSON output format is enabled in your SearXNG configuration.

# Example: Run SearXNG using Docker
docker run -d -p 8080:8080 searxng/searxng

In your SearXNG settings.yml, verify that the search format includes JSON:

search:
  formats:
    - json

Once the server is running, configure the Openclaw Skills tool to point to your local endpoint, typically http://localhost:8080/search.

Search Web (SearXNG) Data Schema & Taxonomy

The skill utilizes a simple input schema and returns a structured list of web results. This makes it easy to integrate with other Openclaw Skills that require predictable data formats.

Attribute Description
query The search string sent to the API.
title The display name or headline of the search result.
url The direct link to the web resource.

Example Output:

[
  {
    "title": "Example Research Paper",
    "url": "https://example.com/paper"
  }
]

Search Web (SearXNG) Advanced Features

  • Local-first architecture ensures that your search history and queries remain private within your own network.
  • Compatible with multi-agent research workflows where one agent searches and another synthesizes the results.
  • Can be configured to search specific categories (e.g., files, images, or news) by modifying the underlying SearXNG instance settings.
  • Eliminates reliance on expensive or restrictive third-party search APIs, making it a cost-effective solution for high-volume Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*