Manage and integrate a local, decentralized YaCy search engine into your AI workflows for private web searches.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install yacy
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 yacy 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 YaCy Skill?
The YaCy Skill enables developers and privacy-conscious users to run their own distributed search engine directly within their environment. By leveraging Openclaw Skills, you can automate the management of the YaCy daemon and use it as a primary source for web information, ensuring your search queries never leave your local infrastructure or the P2P network. This skill bridges the gap between AI-driven research and local-first data sovereignty.
YaCy Skill Use Cases
- Establishing a private, self-hosted alternative to commercial search APIs like Brave or Google.
- Integrating decentralized search results into AI-driven research and data gathering workflows.
- Automating the lifecycle of the YaCy container for efficient resource management in home labs.
How YaCy Skill Works
- The user provisions a YaCy search server using Docker, which is managed through Openclaw Skills tools.
- The skill provides commands like
yacy_startandyacy_stopto interface with the local container service. - When configured, the
yacy_searchtool queries the local YaCy RSS API to retrieve decentralized search results. - These results are processed and returned to the agent, allowing it to browse the web without external API dependencies.
YaCy Skill Setup
To install and configure the YaCy Skill, ensure Docker is running and execute the following command to start the persistent container:
docker run -d --name yacy_search_server -p 8090:8090 -p 8443:8443 -v yacy_search_server_data:/opt/yacy_search_server/DATA --restart unless-stopped --log-opt max-size=200m --log-opt max-file=2 yacy/yacy_search_server:latest
Access the web interface at http://localhost:8090 (default credentials: admin / yacy). To set this as your primary search tool, update your configuration with tools.defaultSearch = "yacy_search" and ensure the yacy_dir points to your workspace directory.
YaCy Skill Data Schema & Taxonomy
The skill manages configuration and index data through localized parameters and Docker volumes:
| Parameter | Default Value | Description |
|---|---|---|
| yacy_dir | /home/q/.openclaw/workspace/yacy_search_server | Path to local installation metadata |
| port | 8090 | Primary HTTP port for API and Web UI |
| Docker Volume | yacy_search_server_data | Persistent storage for the crawl index and settings |
| Default Auth | admin / yacy | Initial credentials for the search dashboard |
YaCy Skill Advanced Features
- Default Search Replacement: Seamlessly swap out Brave Search or other providers by configuring
yacy_searchas the global default search tool. - Decentralized Networking: Participate in the global YaCy P2P network to contribute to and benefit from a shared, uncensored search index.
- Automated Service Monitoring: Use the
yacy_statustool to check service health and view real-time logs within your Openclaw Skills environment.
SKILL.md
Loading
Related Openclaw Skills
tokenQrusher
tokenQrusher is a high-performance optimization system that drastically reduces AI agent token usage through intelligent context filtering and heartbeat management.
Token Optimizer
A comprehensive toolkit designed to drastically reduce token usage and API expenditures through intelligent context management and task-based model routing.
Session State Tracker
A robust lifecycle management tool that prevents context loss by automatically persisting and restoring AI agent state across compactions and restarts.
Curated Search
A domain-restricted local search engine that provides authoritative technical documentation results without web spam.
Browser DevTools Inspector
An automated utility to capture and analyze browser console, network, and performance data for professional frontend debugging.
Economic Calendar
A specialized scraping utility that retrieves macro-economic events and financial indicators from Investing.com without an API key.
Featured*
