核心用法
Free Local Web Search 是一款专为 OpenClaw 设计的本地化网络搜索解决方案,完全替代内置的 web_search 功能。该技能基于 SearXNG 搜索引擎框架,通过本地部署实现 100% 免费的网络搜索能力,用户无需注册任何 API 密钥即可使用。
部署方式极为简洁:在本地环境中启动 SearXNG 服务后,技能通过 localhost 接口与之通信,所有搜索请求均在本地完成,不经过第三方云服务器。配置文件中已预设安全参数,包括请求速率限制(Limiter)和安全搜索过滤(Safe Search),有效防止滥用和不当内容返回。
显著优点
1. 零成本运营:完全摆脱 Brave API 等商业搜索服务的付费模式,长期使用无经济负担
2. 隐私保护:搜索行为完全本地化,查询记录、点击数据不会上传至外部服务器,杜绝商业追踪
3. 无需凭证:省去 API 密钥申请、管理和轮换的繁琐流程,即装即用
4. 架构透明:基于开源 SearXNG 项目,代码可审计,无黑盒操作
5. 低延迟:本地网络通信,响应速度通常优于远程 API 调用
潜在缺点与局限性
- 部署门槛:需在本地预装 Docker 或 Python 环境并运行 SearXNG 服务,对非技术用户不够友好
- IP 暴露风险:SearXNG 向目标网站发起请求时使用本机 IP,频繁搜索可能导致 IP 被搜索引擎封禁
- 功能局限:相比商业 API,缺乏高级过滤、语义理解、结果排序优化等特性
- 维护责任:用户需自行更新 SearXNG 实例以获取安全补丁和新引擎支持
- 结果质量:依赖 SearXNG 的元搜索引擎聚合能力,部分垂直领域搜索结果可能不如专业 API
适合人群
- 注重隐私、拒绝云服务的安全意识用户
- 开发测试环境中需要频繁调用搜索功能的开发者
- 预算敏感的个人项目和小型团队
- 具备基础 Linux/Docker 运维能力的技术用户
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 本地服务暴露 | 若 SearXNG 未正确绑定 127.0.0.1,可能被局域网或公网访问 | 严格配置 `--bind 127.0.0.1` |
| 资源滥用 | 无限制的本地请求可能触发目标站点的反爬机制 | 依赖内置 Limiter 控制频率 |
| 结果不可信 | 元搜索引擎可能返回过时或被操纵的摘要 | 关键信息需人工二次验证 |
| 依赖中断 | SearXNG 项目维护状态或引擎可用性变化 | 定期检查实例健康状态 |