文章目录
- OpenClaw + Docker 部署 SearXNG 完整教程:打造稳定的本地 AI 联网搜索
- 一、为什么必须本地部署 SearXNG?
- 二、环境准备
- 三、创建 SearXNG 配置文件(⚠️ 核心避坑点)
- 四、编写 Docker Compose 文件
- 五、启动并验证 SearXNG
- 1. 启动容器
- 2. 验证 Web UI
- 3. 验证 JSON API(⚠️ 必须测试)
- 六、接入 OpenClaw
- 1. 修改 OpenClaw 配置
- 2. 重启 OpenClaw Gateway
- 七、在 OpenClaw 中实测搜索能力
- 八、常见问题与避坑指南 (FAQ)
- Q1: API 调用返回 `403 Forbidden`
- Q2: 容器启动失败,提示端口被占用
- Q3: SearXNG 搜索结果为空或报错 `Timeout`
- Q4: 重启电脑后 SearXNG 失效了?
- 九、总结
- 📚 相关阅读
OpenClaw + Docker 部署 SearXNG 完整教程:打造稳定的本地 AI 联网搜索
环境信息
- OS: macOS 15 (同样适用于 Linux / Windows WSL2)
- Docker: Docker Desktop (最新版)
- OpenClaw: 2026.7.1
- 目标: 在本地搭建一个稳定、无广告、支持 JSON API 的 SearXNG 搜索引擎,并完美接入 OpenClaw Agent。
在上一篇文章《OpenClaw 集成 SearXNG 实战:从踩坑到成功部署》中,我们解决了 Node 版本路径漂移和插件元数据冲突的问题,并得出结论:不要依赖公网 SearXNG 实例,本地 Docker 部署才是王道。
今天这篇是续集,我将手把手带你从零开始,用 Docker 部署 SearXNG,并打通 OpenClaw 的联网搜索能力。整个过程大约只需 5 分钟,但能帮你省下购买商业搜索 API(如 Tavily、Serper)的长期费用。
一、为什么必须本地部署 SearXNG?
在让 AI Agent 具备联网能