核心用法
Brave API Free Search 是一个面向 OpenClaw 的免费搜索代理技能，旨在完全替代付费的 Brave Search API。用户通过本地 Docker 部署 SearXNG 搜索引擎实例，配合 Python 脚本实现零成本网络搜索能力。
部署流程：
1. 确保系统已安装 docker 和 python3
2. 安装 Python 依赖：pip install requests
3. 运行安装脚本：python scripts/install.py
4. 可选开发模式：--dev 参数（禁用安全限制）
技术架构：
- 底层基于
local-search-pro和 SearXNG 开源搜索引擎 - 自动部署持久化 Docker 容器（
searxng-local），配置--restart unless-stopped - 默认启用
safe_search内容过滤和请求限速（limiter） - 网络隔离：仅限 localhost 访问，不暴露公网
显著优点
| 维度 | 优势 |
|------|------|
| **成本** | 完全免费，无 API Key 需求，无调用额度限制 |
| **隐私** | 本地部署，搜索请求不经过第三方商业服务 |
| **安全** | 默认启用安全搜索过滤，儿童/工作场景友好 |
| **稳定性** | Docker 容器持久化运行，自动重启保障可用性 |
| **可控性** | 开源 MIT 协议，代码透明可审计 |
潜在缺点与局限性
1. 部署复杂度：相比直接调用云端 API，需要本地 Docker 环境，对非技术用户门槛较高
2. 维护负担：用户需自行管理容器生命周期（更新、故障排查、磁盘占用）
3. 搜索结果质量：SearXNG 聚合多引擎结果，但可能不如 Brave API 的索引深度和实时性
4. 网络依赖：仍需访问外部搜索引擎源（Google、Bing 等），非完全离线方案
5. IP 风险：本地出口 IP 直接请求目标搜索引擎，高频使用可能触发反爬机制
适合人群
- 开发者/技术用户：熟悉 Docker 和命令行操作，追求低成本自动化工作流
- 隐私敏感用户：不愿将搜索数据提交给商业 API 服务商
- OpenClaw 生态用户：需要无缝集成到 OpenClaw 代理框架
- 轻量级搜索场景：对搜索延迟不敏感、查询量适中的个人或小型团队
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| **容器安全** | Docker 容器以 `--restart unless-stopped` 持久运行，若镜像存在漏洞可能长期暴露 | 定期更新镜像，使用 `docker rm -f searxng-local` 及时清理 |
| **开发模式风险** | `--dev` 标志禁用 `safe_search` 和 `limiter`，可能返回未过滤内容并增加被封禁风险 | 仅限本地开发使用，生产环境严禁启用 |
| **资源占用** | 持续运行的容器消耗内存和磁盘（SearXNG 约需 200-500MB） | 监控资源使用，必要时停止容器 |
| **合规风险** | 大规模爬取搜索引擎可能违反源站 ToS | 控制请求频率，遵守各搜索引擎使用政策 |
| **依赖维护** | 上游 SearXNG 或 `local-search-pro` 更新可能导致兼容性问题 | 关注版本更新，测试后再升级 |
总结评估
该技能是成本优先场景的实用选择，以技术自主性换取商业 API 费用。适合愿意承担运维责任的技术用户，但不推荐给追求即开即用、零维护的商业环境。安全设计（localhost 隔离、安全搜索默认启用）体现了隐私友好理念，但用户需警惕开发模式的潜在风险。