@agentclaws/openclaw-searxng

Privacy-respecting web search for OpenClaw agents via self-hosted SearXNG. Your agent searches the web without sending queries to Google, Bing, or any third party.

Quick Start

openclaw plugins install @agentclaws/openclaw-searxng

Requires a running SearXNG instance (Docker setup included).

Requirements

# Docker must be installed
curl -fsSL https://get.docker.com | sh

# Start SearXNG container
cd node_modules/@agentclaws/openclaw-searxng/docker
docker compose -f docker-compose.searxng.yml up -d

Tools Registered

| Tool | Description | |------|-------------| | web_search | General web search across all engines | | web_search_news | Time-filtered news search |

How It Works

1. Agent decides it needs to search the web
2. Calls web_search or web_search_news tool
3. Plugin queries your local SearXNG instance
4. Results returned to agent context with titles, URLs, and snippets
5. Agent uses results to answer your question

All queries stay on your server. No API keys. No tracking. No cost per search.

Config

{
  "plugins": {
    "entries": {
      "searxng": {
        "enabled": true,
        "config": {
          "baseUrl": "http://localhost:8090",
          "maxResults": 10
        }
      }
    }
  }
}

| Option | Default | Description | |--------|---------|-------------| | baseUrl | — | URL of your SearXNG instance (required) | | maxResults | 10 | Max results per search | | apiKey | — | Optional SearXNG API key | | defaultEngines | [] | Restrict to specific engines | | defaultCategories | [] | Restrict to categories | | safeSearch | 0 | 0=off, 1=moderate, 2=strict | | timeoutMs | 10000 | Request timeout |

Self-Hosted SearXNG Setup

The plugin includes a Docker Compose setup:

cd docker
docker compose -f docker-compose.searxng.yml up -d

This starts SearXNG on 127.0.0.1:8090 (localhost only) with Redis caching. Edit searxng-settings.yml to customize engines and settings.

Port Conflict?

Default is 8080. If taken, change in docker-compose.searxng.yml:

ports:
  - "127.0.0.1:8090:8080"  # Change 8090 to any free port

License

MIT

Support

If this plugin is useful, consider supporting development:

• XMR: 846W4nu6fdHCFbbhW9Peu4FNvdFYKBoLKTWntFinf939fZSEJVjuPrgfkaUGiJeZ2uD4Cen3U8FKVPzsAcjUM6SqF9xQ7Am
• SOL (SOL/USDC/USDT): F47DjKkZBJD9Jcm6LdWZCar1Z9aMP8JYG6FbtKjLDbP6