OpenClaw 集成 SearXNG 实战:从踩坑到成功部署(macOS + Docker)

文章目录

  • 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 安装第三方插件。

安装非常简单: