free-local-web-search

核心用法

Free Local Web Search 是一款专为 OpenClaw 设计的本地搜索技能，通过 Docker 在本地部署 SearXNG 实例，实现完全免费的网络搜索能力。

部署方式

# 标准安全模式
python scripts/install.py

# 开发模式（⚠️ 禁用安全限制）
python scripts/install.py --dev

工作原理

• 自动拉取并运行 searxng-local Docker 容器
• 默认启用 safe_search 和 limiter 安全机制
• 仅限 localhost 访问，杜绝外网暴露风险
• 支持 --restart unless-stopped 持久化运行

环境依赖

| 组件 | 要求 |

|------|------|

| Docker | 必需 |

| Python 3 | 必需 |

| `SEARXNG_BASE_URL` | 环境变量配置 |

显著优点

1. 零成本：完全免费，无需订阅 Brave Search、Google API 等付费服务
2. 隐私优先：查询全程本地处理，不经过第三方日志记录
3. 无密钥依赖：无需申请、管理或轮换 API Key
4. 元搜索聚合：SearXNG 同时查询多个引擎，结果更全面
5. 网络隔离：localhost-only 设计，天然防火墙友好

潜在缺点与局限

| 问题 | 说明 |

|------|------|

| 资源占用 | 需持续运行 Docker 容器，占用本地内存/CPU |

| 维护负担 | 镜像更新、容器故障需自行排查 |

| 结果质量 | 依赖上游引擎，可能不如商业 API 稳定 |

| 网络限制 | 部分引擎可能因 IP 地理位置降级服务 |

| Dev 模式风险 | `--dev` 参数会**完全关闭安全防护**，误用易导致滥用 |

适合人群

• 注重搜索隐私的技术用户
• 希望消除 API 成本的个人开发者 / 小团队
• 需要离线/内网搜索能力的场景
• 已有 Docker 运维经验的环境

常规风险

1. 容器逃逸风险：Docker 守护进程漏洞可能影响宿主机
2. Dev 模式滥用：禁用 limiter 后无速率保护，易被目标站封禁
3. 上游数据质量：SearXNG 聚合结果可能包含未过滤内容
4. 持久化容器误删：--restart unless-stopped 意味着手动 docker rm -f 才能停止，遗忘会导致资源持续占用

---

> 建议生产环境始终使用默认安全模式，开发模式仅限本地调试且需明确知情同意。