核心用法
free-local-web-search 是专为 OpenClaw 设计的零成本网页搜索解决方案，旨在替代需要 Brave API 密钥的内置 web_search 功能。用户通过简单的 Python 脚本即可完成安装和搜索操作：
# 安装 python scripts/install.py # 搜索 python scripts/search.py "查询内容"
该方案基于 local-search-pro 引擎驱动，采用自托管 SearXNG 架构，所有搜索流量在本地完成，不依赖外部付费 API。
显著优点
- 完全免费：无 $5/月的 Brave API 订阅成本，适合个人开发者和小型团队
- 零配置门槛：无需申请、管理或轮换 API 密钥，降低运维复杂度
- 隐私友好：自托管架构确保搜索数据不流经第三方商业服务
- 轻量集成：不修改全局 OpenClaw 配置，卸载干净无残留
- 开源可控：MIT 许可证，代码透明可审计
潜在缺点与局限性
- 基础设施依赖：需自行维护 SearXNG 实例，对服务器资源和网络稳定性有要求
- 搜索结果质量：相比商业 API（如 Brave），SearXNG 的检索结果排序和相关性可能参差
- 无 SLA 保障：自托管服务无官方技术支持，故障排查需用户自行处理
- IP 封禁风险：频繁搜索可能触发目标站点的反爬机制，需配合代理池使用
- 功能阉割：基础版本缺少 Docker 自动部署、健康检查等高级特性（需升级至 local-search-pro）
适合人群
- 预算敏感的个人开发者与开源项目维护者
- 注重搜索隐私、不愿数据出境的用户
- 已具备 Linux/Docker 运维能力的技术团队
- 需要批量/高频搜索场景（规避 API 限流和计费）
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 服务可用性 | 自托管实例可能因网络、资源不足中断 | 配置进程守护与告警 |
| 搜索结果偏差 | 多源聚合引擎的结果一致性弱于商业 API | 关键场景人工复核 |
| 合规风险 | 爬虫行为需遵守 robots.txt 及当地法规 | 配置请求频率限制 |
| 升级维护 | 引擎版本迭代需手动跟进 | 关注 SearXNG 安全公告 |