核心用法
Local Free Web Search 是一款面向 OpenClaw 的本地化搜索技能,主打零成本、零 API 密钥、完全本地运行。核心架构由两大组件驱动:
- SearXNG:自托管元搜索引擎,聚合 Bing/DuckDuckGo/Google/Startpage/Qwant 等多源结果
- Scrapling:本地反爬虫引擎,三层爬取策略(Fetcher → StealthyFetcher → DynamicFetcher)应对 Cloudflare 和 JS 渲染站点
主要工具
| 工具 | 功能 |
|---|---|
| `search_local_web.py` | 多引擎并行搜索,支持意图识别(general/factual/news/research 等 7 类)、时效过滤、结果交叉验证 |
| `browse_page.py` | 单页深度读取,三种模式(fast/stealth/dynamic)适配不同反爬强度,返回置信度评级(HIGH/MEDIUM/LOW) |
典型工作流
1. 用 search_local_web.py 检索 → 优先采信带 [cross-validated] 标签的多引擎共识结果
2. 用 browse_page.py 读取高置信度页面全文
3. 遇阻时切换 --mode stealth 或换源,禁止仅依赖搜索摘要作答
显著优点
- 完全免费:无 API 调用成本,无用量限制
- 隐私优先:查询默认走本地 SearXNG,无第三方追踪;公开实例
searx.be仅作 fallback,仅接收原始查询字符串 - 反幻觉机制:多引擎交叉验证 + 页面置信度评级,降低大模型编造风险
- 自适应爬取:三级 Fetcher 策略自动或手动应对现代 Web 防护
- 意图感知:7 类预设意图优化引擎选择和查询扩展
潜在缺点与局限
| 局限 | 说明 |
|---|---|
| 本地依赖 | 需用户自行维护 SearXNG 实例,占用本地资源 |
| 技术门槛 | Docker/脚本运维能力要求,非开箱即用 |
| fallback 信任 | `searx.be` 为公共实例,虽仅接收查询字符串,但仍需基础信任 |
| 动态内容限制 | JS 重度站点(SPA)需 DynamicFetcher,延迟显著增加 |
| 无持久化索引 | 纯实时搜索,不支持离线知识库查询 |
适合人群
- 隐私敏感用户:拒绝商业搜索 API 的数据收集
- 高频搜索场景:日均数十次以上查询,API 成本敏感
- 技术型用户:具备 Docker/本地服务运维能力
- 事实核查需求:研究、新闻、学术场景需多源交叉验证
常规风险
- 服务可用性:本地 SearXNG 未启动时自动降级到
searx.be,极端情况下可能完全失败 - 法律合规:爬取行为需遵守目标站点 robots.txt 及当地法规
- 内容可信度:公开 fallback 实例的结果质量不受技能控制
- 反爬对抗:目标站点持续升级防护,Scrapling 策略可能滞后