核心功能
Free Local Web Search 是一款面向 OpenClaw 生态的本地化网页搜索技能，通过 Docker 容器化部署 SearXNG 元搜索引擎，实现完全自主可控的搜索能力。
部署与架构
采用本地独占模式运行，仅监听 localhost 地址，拒绝外部网络访问请求。依赖 Docker 和 Python 3 环境，通过 scripts/install.py 脚本自动化完成容器编排与配置注入。环境变量 SEARXNG_BASE_URL 用于指定服务终端节点。
安全机制
- Limiter：内置请求速率限制，防止滥用与爬虫过载
- safe_search：强制启用安全搜索过滤，屏蔽成人内容与高风险结果
- Network Isolation：localhost-only 绑定策略，杜绝公网暴露风险
开发模式
支持 --dev 调试标志，该模式会禁用上述全部安全机制，仅适用于本地开发调试场景，生产环境严禁启用。
显著优点
1. 零成本运营：无需订阅 Brave API、Bing API 或 SerpAPI 等商业服务
2. 隐私优先：查询数据不经过第三方服务器，完全本地闭环
3. 元搜索聚合：SearXNG 底层聚合多引擎结果，提升召回率与多样性
4. 部署轻量化：单一 Docker 容器即可运行，资源占用可控
局限性与风险
- 基础设施依赖：要求目标环境具备 Docker 运行时，边缘设备兼容性受限
- IP 封禁风险：高频爬取可能导致源搜索引擎对出口 IP 实施限流或封禁
- 结果质量波动：依赖上游引擎可用性，无商业 SLA 保障
- 运维责任：需自行监控容器健康状态与存储空间
适用人群
- 注重隐私的个人开发者与技术爱好者
- 需要批量/高频搜索且预算受限的自动化工作流
- 内网/离线环境需搜索能力的特殊场景
常规风险提示
- 开发模式 (
--dev) 会移除内容过滤与请求限制，误用可能导致法律合规风险或网络攻击面扩大 - 未配置反向代理时，需确保防火墙规则阻止外部访问 127.0.0.1 以外的接口绑定
- 长期运行需关注 SearXNG 镜像与依赖的安全更新