YaCy 技能:本地与私有 P2P 搜索集成 - Openclaw Skills

作者:互联网

2026-04-17

AI教程

什么是 YaCy 技能?

YaCy 技能使开发人员和注重隐私的用户能够在自己的环境中直接运行分布式搜索引擎。通过利用 Openclaw Skills,您可以自动化管理 YaCy 守护进程,并将其作为主要网络信息源,确保您的搜索查询永远不会离开本地基础设施或 P2P 网络。该技能填补了 AI 驱动研究与本地优先数据主权之间的空白。

下载入口:https://github.com/openclaw/skills/tree/main/skills/qsmtco/yacy

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install yacy

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 yacy。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

YaCy 技能 应用场景

  • 建立私有的、自托管的替代方案,取代 Brave 或 Google 等商业搜索 API。
  • 将去中心化搜索结果集成到 AI 驱动的研究和数据收集工作流中。
  • 自动化 YaCy 容器的生命周期,实现家庭实验室的高效资源管理。
YaCy 技能 工作原理
  1. 用户使用 Docker 部署 YaCy 搜索服务器,并通过 Openclaw Skills 工具进行管理。
  2. 该技能提供 yacy_startyacy_stop 等命令,与本地容器服务交互。
  3. 配置完成后,yacy_search 工具会查询本地 YaCy RSS API 以检索去中心化搜索结果。
  4. 这些结果经过处理后返回给代理,使其能够在不依赖外部 API 的情况下浏览网页。

YaCy 技能 配置指南

要安装和配置 YaCy 技能,请确保 Docker 正在运行,并执行以下命令启动持久化容器:

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

访问 Web 界面:http://localhost:8090(默认凭据:admin / yacy)。要将其设置为您的首选搜索工具,请将配置更新为 tools.defaultSearch = "yacy_search",并确保 yacy_dir 指向您的工作区目录。

YaCy 技能 数据架构与分类体系

该技能通过本地化参数和 Docker 卷管理配置和索引数据:

参数 默认值 描述
yacy_dir /home/q/.openclaw/workspace/yacy_search_server 本地安装元数据的路径
port 8090 API 和 Web UI 的主要 HTTP 端口
Docker Volume yacy_search_server_data 抓取索引和设置的持久化存储
默认身份验证 admin / yacy 搜索仪表板的初始凭据

YaCy Skill

Control and manage a local YaCy search engine instance.

Description

This skill provides an interface to interact with YaCy, the open-source distributed search engine, running on localhost. It allows you to start/stop the service, check status, and integrate search capabilities into your OpenClaw workflows.

Prerequisites

  • Docker installed and running
  • Ports 8090 and 8443 available on localhost

Installation

The YaCy container runs with persistent data stored in a Docker volume (yacy_search_server_data). To install:

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 (change after first login)

Capabilities

  • Start YaCy container/daemon
  • Stop YaCy container/daemon
  • Check YaCy status
  • Perform web searches (RSS API)
  • Manage indexing (future)

Tools

This skill provides:

  • yacy_start - Start the YaCy service
  • yacy_stop - Stop the YaCy service
  • yacy_status - Check if YaCy is running and view logs
  • yacy_search - Perform a search query (replaces Brave search when configured as default)

Configuration

Set in OpenClaw config or via environment:

  • yacy_dir - Path to YaCy installation (default: /home/q/.openclaw/workspace/yacy_search_server)
  • port - HTTP port (default: 8090)

To make YaCy your default web search:

  1. Install and start YaCy
  2. Set OpenClaw config: tools.defaultSearch = "yacy_search"
  3. Remove BRAVE_API_KEY environment variable if set

Now all "search for X" requests will use your local YaCy instance instead of Brave.

Notes

YaCy runs completely locally and can be used as a privacy-focused search solution. It also participates in the global YaCy peer-to-peer network by default, but this can be disabled in settings.

License

GPL 2.0+ (same as YaCy)


Created: 2026-02-11 Skill version: 0.1.0 Target OpenClaw: 2026.2.9+