文章目录
- OpenClaw 集成 SearXNG 实战：从踩坑到成功部署（macOS + Docker）
- 一、安装 ClawHub
- 二、安装 SearXNG Plugin
- 三、问题定位：Node 版本与路径漂移
- 四、尝试修复：Doctor 命令的局限
- 五、彻底解决：统一 Node 环境
- 六、验证配置与插件状态
- 七、解析 Doctor Warning 的真相
- 八、配置 SearXNG：从公网到本地
- 九、最终方案：Docker 本地部署 SearXNG
- 十、排坑总结表
- 十一、最佳实践建议
- 后记
- 📚 相关阅读
OpenClaw 集成 SearXNG 实战：从踩坑到成功部署（macOS + Docker）
环境信息
- OS: macOS 15
- Node.js: 24.18.0 (通过 nvm 管理)
- OpenClaw: 2026.7.1
- 工具: Docker Desktop, ClawHub CLI
- 目标: 为 OpenClaw 接入 SearXNG 实现联网搜索能力
最近在搭建本地 AI Agent，希望让 OpenClaw 具备联网搜索能力，因此选择了SearXNG作为 Web Search Provider。
整个过程并没有想象中顺利，从 Node 版本冲突、插件路径失效，到 OpenClaw 插件元数据冲突，再到公网 SearXNG 实例无法访问，几乎把所有坑都踩了一遍。本文记录完整过程，希望能够帮助后来者少走弯路。
一、安装 ClawHub
OpenClaw 官方推荐通过 ClawHub 安装第三方插件。
安装非常简单：