← Back to Skills Marketplace
492
Downloads
1
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install free-local-web-search
Description
100% FREE local web search for OpenClaw. Secure localhost-only SearXNG deployment. Supports hidden --dev flag.
README (SKILL.md)
🌐 Free Local Web Search (Secure)
✅ Completely FREE
Python Dependency
The runtime scripts require the Python package requests.
Install if missing:
pip install requests
✅ Localhost-only deployment
✅ Limiter + safe_search enabled
Dev mode available:
python scripts/install.py --dev
⚠ Dev mode disables safe_search and limiter (reduced safety). For local development only.
Powered by local-search-pro.
⚠ Installation deploys a persistent Docker container (searxng-local) with --restart unless-stopped.
To remove it:
docker rm -f searxng-local
Usage Guidance
What to consider before installing:
- The scripts will run docker run searxng/searxng, which pulls a Docker image from Docker Hub. Inspect that image's trustworthiness (publisher, image contents) before running.
- "Localhost-only" refers to binding the service to 127.0.0.1, not preventing the container from making outbound network connections. SearXNG will query upstream search engines unless you configure it otherwise, which can expose query data and reveal your host IP to third parties.
- The installer creates a persistent container with --restart unless-stopped. If you want ephemeral usage, remove that flag or run the container with manual control; remove the container with docker rm -f searxng-local when done.
- Dev mode (--dev) disables safe_search and limiter — do not use it if you expect safety/filtering.
- If you are concerned about egress, consider running the container with restricted network mode (for example --network=none) and/or running a proxy that enforces allowed destinations, or inspect/modify SearXNG backend settings to restrict engines.
- The install script uses shell=True to execute docker commands. This is not inherently malicious here, but only run code you trust and consider reviewing/ running commands manually instead of executing the script blindly.
If you understand and accept these tradeoffs (trust the upstream Docker image, accept outbound queries, and the persistent container behavior), the package is coherent with its stated purpose; otherwise do not install.
Capability Analysis
Type: OpenClaw Skill
Name: free-local-web-search
Version: 1.0.7
The skill provides a local web search capability by deploying a SearXNG instance via Docker. The implementation in scripts/install.py and scripts/search.py is transparent, mapping the service to localhost (127.0.0.1) to ensure privacy. While it uses shell=True in subprocess calls and establishes persistence via Docker's --restart unless-stopped flag, these behaviors are documented and consistent with the stated goal of providing a persistent local search service.
Capability Assessment
Purpose & Capability
Name/description match the code: scripts deploy and query a local SearXNG instance and require docker + python3. Requested binaries and included scripts are proportionate to the stated goal. Minor mismatch: marketing text claims "secure localhost-only" but the deployment permits the container to make outbound network requests to search engines, which can leak queries — this is not called out in the README.
Instruction Scope
Runtime instructions and scripts only read/write a local settings.yml and contact the configured SEARXNG_BASE_URL (defaults to 127.0.0.1). However the SKILL.md does not call out that SearXNG itself will perform outbound network requests to upstream search engines. The install also persists a container and does not apply any egress/network restrictions; that omission reduces privacy and contradicts the strong implication of fully-local/secure operation. Dev mode explicitly disables safety controls (safe_search + limiter), which is documented but risky if used unknowingly.
Install Mechanism
This is instruction/script-based (no package install spec). The install script runs docker run which will pull the image searxng/searxng from Docker Hub — a common pattern, but it means arbitrary upstream image code is fetched at install time. Use of subprocess.run(..., shell=True) to assemble commands is functional here but carries the usual shell-injection risks if inputs were untrusted (the script uses __file__-derived paths so risk is low in practice).
Credentials
The skill requests no credentials or sensitive environment variables. It uses an optional SEARXNG_BASE_URL override (read from env) which is reasonable and declared in scripts. No unexpected secrets are requested.
Persistence & Privilege
The install deploys a long-lived Docker container with --restart unless-stopped, making the service persistent on the host until explicitly removed. The skill does not set any container network egress restrictions, so the container can initiate outbound connections. 'always' is false (normal), but persistence of a container is effectively elevated presence and should be considered before installing.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install free-local-web-search - After installation, invoke the skill by name or use
/free-local-web-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.7
Remove required env (SEARXNG_BASE_URL optional). Declare Python dependency: requests.
v1.0.6
Add persistence notice (Docker container runs persistently). Clarify uninstall command.
v1.0.5
Declare SEARXNG_BASE_URL env var and clarify dev mode safety impact.
v1.0.4
Add required binaries metadata (docker, python3). Fix registry dependency declaration.
v1.0.3
Sync with [email protected] (SearXNG 2026 compatibility fix).
v1.0.2
- Added support for a hidden --dev flag in the installer script.
- Updated documentation to reflect --dev mode and clarified deployment details.
- Removed obsolete references to API keys and streamlined feature list.
v1.0.1
free-local-web-search 1.0.1
- Added secure localhost-only deployment for SearXNG.
- Enabled request limiter and safe search by default.
- Updated description and keywords for improved clarity and focus on security.
- Improved installation and usage instructions in documentation.
v1.0.0
- Initial release of free-local-web-search.
- Provides 100% free, self-hosted web search for OpenClaw with no API key required.
- Uses a local SearXNG engine powered by local-search-pro.
- No monthly fees or external paid APIs needed.
- Quick start instructions included; does not modify global OpenClaw configuration.
Metadata
Frequently Asked Questions
What is free-local-web-search?
100% FREE local web search for OpenClaw. Secure localhost-only SearXNG deployment. Supports hidden --dev flag. It is an AI Agent Skill for Claude Code / OpenClaw, with 492 downloads so far.
How do I install free-local-web-search?
Run "/install free-local-web-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is free-local-web-search free?
Yes, free-local-web-search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does free-local-web-search support?
free-local-web-search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created free-local-web-search?
It is built and maintained by pipe (@pipepi); the current version is v1.0.7.
More Skills