Private Search for OpenClaw
Route all web searches through privacy-respecting engines. No ads. No tracking. No query monetization.
Why This Exists
OpenAI now shows ads to ChatGPT users and routes queries through ad-network-partnered search APIs. OpenClaw defaults to Google/Bing-backed search — both of which monetize your queries. This skill replaces that with:
- - Brave Search — independent index, no ad tracking, free tier available
- Kagi — premium ad-free search, best result quality
- SearXNG — fully self-hosted, zero third-party dependency
Quick Setup (Brave Search — Recommended)
- 1. Get a free Brave Search API key: https://api.search.brave.com/
- Set env var: INLINECODE0
- Done. All agent web searches now route through Brave.
Configuration
Set any of these in your OpenClaw environment:
| Variable | Description | Default |
|---|
| INLINECODE1 | Brave Search API key | Required for Brave |
| INLINECODE2 |
Kagi API key | Optional |
|
SEARXNG_URL | Self-hosted SearXNG URL | Optional |
|
PRIVATE_SEARCH_ENGINE |
brave,
kagi, or
searxng |
brave |
|
PRIVATE_SEARCH_RESULTS | Number of results to return |
5 |
|
PRIVATE_SEARCH_STRIP_TRACKING | Strip UTM/tracking params from URLs |
true |
Usage
Once configured, use web search naturally. This skill overrides the default search behavior:
CODEBLOCK0
All queries route through your chosen private engine.
Engine Comparison
| Engine | Cost | Privacy | Index Quality | Best For |
|---|
| Brave | Free tier (2,000/mo) / $3/mo for 20K | High | Good | Most users |
| Kagi |
$10–$25/mo | Highest | Excellent | Power users |
| SearXNG | Self-hosted (free) | Maximum | Varies | Devs/privacy maximalists |
How It Works
This skill provides a private_web_search tool that:
- 1. Accepts a query string and optional parameters
- Routes to your configured engine via API
- Strips tracking parameters from all result URLs (UTM, fbclid, gclid, etc.)
- Returns clean, structured results
- Never logs queries to third-party ad networks
Scripts
Run the setup script for guided configuration:
CODEBLOCK1
References
See references/privacy-engines.md for full engine documentation, pricing tiers, and self-hosting instructions for SearXNG.
Privacy Guarantee
This skill never sends your queries to Google, Bing, or any ad-network-affiliated search provider when properly configured. Your research stays private.
Published on ClawHub. Built in response to OpenAI's March 2026 ad rollout.
技能名称: private-search
详细描述:
OpenClaw 的隐私搜索
将所有网络搜索路由至尊重隐私的搜索引擎。无广告。无追踪。无查询变现。
为何存在
OpenAI 现向 ChatGPT 用户展示广告,并通过广告网络合作搜索 API 路由查询。OpenClaw 默认使用谷歌/必应支持的搜索——两者均会变现你的查询。本技能将其替换为:
- - Brave Search — 独立索引,无广告追踪,提供免费套餐
- Kagi — 高级无广告搜索,最佳结果质量
- SearXNG — 完全自托管,零第三方依赖
快速设置(推荐 Brave Search)
- 1. 获取免费 Brave Search API 密钥:https://api.search.brave.com/
- 设置环境变量:BRAVEAPIKEY=yourkeyhere
- 完成。所有代理网络搜索现通过 Brave 路由。
配置
在 OpenClaw 环境中设置以下任意变量:
| 变量 | 描述 | 默认值 |
|---|
| BRAVEAPIKEY | Brave Search API 密钥 | Brave 必需 |
| KAGIAPIKEY |
Kagi API 密钥 | 可选 |
| SEARXNG_URL | 自托管 SearXNG URL | 可选 |
| PRIVATE
SEARCHENGINE | brave、kagi 或 searxng | brave |
| PRIVATE
SEARCHRESULTS | 返回结果数量 | 5 |
| PRIVATE
SEARCHSTRIP_TRACKING | 从 URL 中剥离 UTM/追踪参数 | true |
使用方法
配置完成后,正常使用网络搜索。本技能会覆盖默认搜索行为:
搜索最新的 OpenAI 新闻
查找 Hetzner VPS 方案定价
本周有哪些顶级 AI 工具?
所有查询均通过你选择的隐私引擎路由。
引擎对比
| 引擎 | 成本 | 隐私性 | 索引质量 | 最佳适用 |
|---|
| Brave | 免费套餐(每月 2,000 次)/ 每月 3 美元 20,000 次 | 高 | 良好 | 大多数用户 |
| Kagi |
每月 10–25 美元 | 最高 | 优秀 | 高级用户 |
| SearXNG | 自托管(免费) | 最高 | 因配置而异 | 开发者/隐私极致主义者 |
工作原理
本技能提供一个 privatewebsearch 工具,其功能如下:
- 1. 接受查询字符串和可选参数
- 通过 API 路由至你配置的引擎
- 从所有结果 URL 中剥离追踪参数(UTM、fbclid、gclid 等)
- 返回干净、结构化的结果
- 绝不将查询记录到第三方广告网络
脚本
运行设置脚本以进行引导式配置:
bash
bash scripts/setup-brave-search.sh
参考
请参阅 references/privacy-engines.md 获取完整的引擎文档、定价层级以及 SearXNG 的自托管说明。
隐私保证
本技能在正确配置下,绝不会将你的查询发送至谷歌、必应或任何广告网络关联的搜索提供商。你的研究保持私密。
发布于 ClawHub。为响应 OpenAI 2026 年 3 月广告推出而构建。