stef-openclaw-skills/docs/searxng.md

searxng

Search the web through a local or self-hosted SearXNG instance.

What this skill is for

• General web search
• News, image, and video search
• Privacy-respecting search without external API keys
• Programmatic search output via JSON

Runtime requirements

• python3
• Python packages: httpx, rich

Configuration

Preferred:

• SEARXNG_URL environment variable

Optional config file:

• workspace .clawdbot/credentials/searxng/config.json
• or ~/.clawdbot/credentials/searxng/config.json

Example:

{
  "url": "https://search.fiorinis.com"
}

Wrapper

Use the bundled script directly:

python3 skills/searxng/scripts/searxng.py search "OpenClaw" -n 5
python3 skills/searxng/scripts/searxng.py search "latest AI news" --category news
python3 skills/searxng/scripts/searxng.py search "OpenClaw" --format json

Notes

• Falls back to http://localhost:8080 if no URL is configured.
• Prints the URL it attempted when connection fails.
• Uses the SearXNG JSON API endpoint.