在 Olares 上为 OpenClaw 启用网页搜索：接入 SearXNG 实时联网能力-育师

云原生
后端
运维

【免费下载链接】Terminus

Open-Source Personal Cloud OS for Always-On Agents

项目地址：https://gitcode.com/gh_mirrors/terminus2/Terminus

OpenClaw 默认仅依赖训练数据作答，无法感知时事新闻与实时网页内容。本文以注重隐私的元搜索引擎 SearXNG 为例，讲解如何在 Olares 应用市场安装自托管 SearXNG、获取其 Endpoint、通过openclaw configure --section web向导接入 OpenClaw 的web_search与web_fetch工具，并验证实时搜索是否生效。读完本文，你将具备一套完整、可复现的"AI 助手联网搜索"配置方案。

背景：为什么需要给 OpenClaw 接入网页搜索

OpenClaw 是一款运行在本地设备上的"始终在线"个人 AI 助手（详见在 Olares 上运行自托管 OpenClaw 智能体）。它能直接连接 Discord、Slack 等消息应用，并执行搜索、发送文档、管理日历、浏览网页等实际任务。但其知识基础来自训练数据，存在明显的时效性边界：

无法获取时事新闻、实时资讯或在线网页的最新内容；
无法基于实时搜索结果回答问题。

因此，官方文档将网页搜索定位为可选增强能力（文档标题即为 "Optional: Enable web search in OpenClaw"），建议为助手接入一个网页搜索服务。Olares 生态中可选的搜索服务不止一种，本文采用官方推荐示例SearXNG——一款注重隐私的元搜索引擎，它聚合多个来源的搜索结果且不追踪用户，并可从 Olares 应用市场安装为自托管实例。

需要说明的是，搜索服务只解决"找到链接和摘要"的问题；若要让助手读取网页完整内容，还需配合全文抓取服务（详见文末"进阶阅读"）。

前提条件

在开始前，请确认以下条件（依据 Olares AI 服务连接前提）：

一台运行Olares 1.12.7 或更高版本、具有足够磁盘空间和内存的 Olares 设备；
已经安装并完成初始化配置的OpenClaw（含 OpenClaw CLI 与 Control UI），并已通过 Router 接入可用的聊天模型（如 Qwen3.8-27B (llama.cpp)）。模型接入的完整流程见将 OpenClaw 作为你的自托管个人 AI 助手运行；
安装 SearXNG 时注意版本兼容性：Olares 1.12.6 起采用新的共享应用架构，若你的 SearXNG 是旧架构安装的，无法原地升级，需要先参考将 SearXNG 迁移到新架构完成迁移。

:::info SearXNG 在 Olares 中的定位 SearXNG 是 Olares 上的共享应用。共享应用由管理员统一部署和管理，集群中的其他成员无需自行安装即可使用，所有共享应用采用统一的https://<app-id>.<username>.<platform-domain>HTTPS 地址格式。更多说明见共享应用。 :::

步骤 1：从应用市场安装 SearXNG

打开应用市场（Market），搜索SearXNG。
点击应用卡片进入详情页，确认其Compatibility字段兼容你当前的 Olares 版本（新架构版本会显示Olares >=1.12.6-0）。
点击获取（Get），然后点击安装（Install），等待安装完成。

安装完成后，SearXNG 会作为一个后台共享服务运行。它不提供独立的桌面界面，主要面向程序化调用——OpenClaw 正是通过其 Endpoint 调用搜索能力的。

步骤 2：获取 SearXNG Endpoint

OpenClaw 需要 SearXNG 的Endpoint作为网络地址来连接其搜索服务。在 Olares 中，当客户端连接另一个应用时，会使用该应用的端点作为网络地址；如果应用暴露了多个端点，应选择与客户端所需功能或协议相匹配的端点（参见AI 服务连接说明中的"应用端点（endpoint）如何工作"）。

操作路径如下：

前往 Olares设置（Settings）>应用（Applications）>SearXNG>入口（Entrances）。
在入口列表中选择SearXNG入口。
复制EndpointURL。

:::info 入口的认证级别为保证同集群内的其他应用（如 OpenClaw）无需登录即可调用 SearXNG 的搜索 API，建议确认该入口的认证级别为内部（Internal）——通过 LarePass VPN 访问的用户无需认证，其他访问均需认证。认证级别的详细说明见管理应用入口与连接 AI 应用与模型服务。 :::

步骤 3：连接 OpenClaw 与 SearXNG

OpenClaw 的网页搜索能力通过配置向导启用，不需要手写配置文件。

打开OpenClaw CLI。
运行以下命令启动配置向导：
```
openclaw configure --section web
```

按如下表格逐项配置：

设置项	选项
Enable the web_search tool	是（Yes）
Search provider	SearXNG Search
SearXNG Base URL	粘贴步骤 2 中复制的 SearXNG Endpoint URL
Install SearXNG plugin	从 npm 下载（@openclaw/searxng-plugin）
Enable the web_fetch tool (keyless HTTP fetch)	是（Yes）

各设置项含义与说明：

Enable the web_search tool：启用后，助手在回答问题时可以调用搜索工具检索实时网页，这是整个集成的核心开关。
Search provider：选择搜索引擎提供方。除 SearXNG Search 外，向导还支持其他 provider（如在线搜索服务），本文以自托管 SearXNG 为例。
SearXNG Base URL：SearXNG 服务的基地址，即步骤 2 复制的 Endpoint。注意必须原样粘贴完整 URL（包括协议与路径），OpenClaw 会在其后拼接搜索查询路径。
Install SearXNG plugin：选择从 npm 下载@openclaw/searxng-plugin插件。插件负责将 OpenClaw 的搜索请求翻译为 SearXNG 的查询协议并解析返回结果。安装插件这类依赖需要由你在 CLI 中手动确认完成——OpenClaw 运行在受限的非 root 环境中，智能体无法自行安装软件（详见管理 OpenClaw 技能和插件）。
Enable the web_fetch tool (keyless HTTP fetch)：启用免密钥的 HTTP 抓取工具，允许助手直接请求并读取网页内容，配合web_search构成"搜索 + 抓取"的完整链路。

等待配置生效。向导提示Configuration updated表示设置已保存。

:::info 与其他客户端的配置一致性同样的配置模式也适用于其他接入 SearXNG 的 AI 客户端。例如 Nemoclaw 等应用同样使用 "Enable web_search"、"SearXNG Base URL"（粘贴从 Olares Settings 复制的 Endpoint）与 "Enable web_fetch" 三项组合（见 Nemoclaw 使用指南）。这印证了 Olares 应用间通过 Endpoint 互连的统一机制。 :::

步骤 4：验证网页搜索是否正常工作

配置完成后，通过一次真实对话验证集成效果：

打开Control UI，与助手开始对话。

提出一个需要最新实时信息的问题，例如：

Tell me the latest top 3 news on this web page https://news.ycombinator.com/newest using your web search tool

检查回复内容。如果助手返回了该页面上的最新信息（而非基于训练数据的旧内容），说明web_search已成功调用 SearXNG，网页搜索集成生效。

验证要点：

观察助手回复是否包含"最新"、"当前"等时效性内容，并正确引用搜索结果中的标题或链接；
若回复内容明显陈旧或表示无法获取网页，优先检查步骤 2 中复制的 Endpoint 是否完整、入口认证级别是否为 Internal；
可再次运行openclaw configure --section web复查各设置项。

进阶阅读：全文检索与完整网页内容

SearXNG 仅返回标题、URL 和摘要（snippet），不会返回完整页面正文；获取完整文本时还可能受到目标站点的反爬取机制限制。如果希望助手能够阅读网页的完整内容，官方推荐在搜索之外叠加一个在线网页服务，例如：

Firecrawl：无头网页数据服务，可将网页转换为干净的 Markdown、结构化 JSON、摘要和元数据。在 Olares 上可作为 Open WebUI、OpenClaw 等应用的网页加载器，通过其 Endpoint 调用/v2/scrape、/v2/crawl等路径。安装与配置见使用 Firecrawl 作为网页加载器。
Tavily：可返回完整文本或答案摘要的搜索/抓取服务，提供免费搜索额度。

典型组合是"SearXNG（搜索）+ Firecrawl（全文抓取）"：先用 SearXNG 找到相关链接，再用 Firecrawl 读取页面正文供助手分析。两者在 Olares 上均为应用市场可安装的服务，Endpoint 获取方式一致（设置 > 应用 > 入口）。