本页内容
本页内容
工具
SearXNG 搜索
OpenClaw 支持 SearXNG 作为一个自托管、无密钥的 web_search 提供商。SearXNG 是一个开源元搜索引擎,会聚合来自 Google、Bing、DuckDuckGo 以及其他来源的结果。
优点:
- 免费且无限制 -- 无需 API 密钥或商业订阅
- 隐私 / 隔离网络 -- 查询绝不会离开你的网络
- Works Anywhere -- 商业搜索 API 无区域限制
设置
安装插件
安装自动应用于正在运行的网关;否则下次启动时生效。请参阅 应用更改并检查 。
运行 SearXNG 实例
或者使用你已有权限访问的任何现有 SearXNG 部署。有关生产环境设置,请参阅 SearXNG 文档。
配置
或者设置环境变量,让自动检测来发现它:
配置
SearXNG 实例的插件级设置:
baseUrl 也接受一个 SecretRef 对象(例如 { source: "env", id: "SEARXNG_BASE_URL" })。
环境变量
将 SEARXNG_BASE_URL 作为配置的替代方案:
解析顺序:仅当 baseUrl 缺失时,配置 baseUrl(字符串或允许的环境 SecretRef),然后配置 SEARXNG_BASE_URL。只读配置检查块不会落入周围环境的显式 SecretRef;改为修复其提供程序、默认提供程序或 env 允许列表策略。当未设置任何配置路径且存在 SEARXNG_BASE_URL 且未选择显式提供程序时,自动检测将选择 SearXNG。
插件配置参考
| 字段 | 描述 |
|---|---|
baseUrl |
你的 SearXNG 实例的基础 URL(必填) |
categories |
以逗号分隔的分类,例如 general、news 或 science |
language |
结果的语言代码,例如 en、de 或 fr |
web_search 工具调用还接受 count(1-10 个结果)、categories 和 language 作为每次调用的覆盖参数。
说明
- JSON API -- 使用 SearXNG 原生的
format=json端点,而不是 HTML 抓取 - 图像结果 URL -- 当 SearXNG 返回直接图像 URL 时,图像类别结果包括
img_src - 无需 API 密钥 -- 可直接与任何 SearXNG 实例配合使用
- 基础 URL 验证 --
baseUrl必须是有效的http://或https://URL - Network Guard --
http://基本 URL 必须针对受信任的私有或环回主机(公共主机必须使用https://);解析为 private/internal 地址的https://基本 URL 获得相同的自托管配额,而公开解析的https://基本 URL 保留严格的 SSRF 保护 - 自动检测顺序 -- SearXNG 需要配置
baseUrl(在已具备所需凭据的提供方中排序为 200)。像 DuckDuckGo 或 Ollama Web Search 这类无密钥提供方不会隐式赢得自动检测;它们仅在显式选择provider时激活 - 自托管 -- 你可以控制实例、查询以及上游搜索引擎
- 类别 在未配置时默认为
general - 类别回退 -- 如果非
general类别请求成功但返回零结果,OpenClaw 会在返回空结果集之前,使用general再重试一次相同查询 - 结果缓存 -- 相同的查询(相同的 query、count、categories、language 和 base URL)会在进程内缓存一小段 TTL
- 版本要求 -- 该插件声明
minHostVersion: >=2026.6.9
相关内容
- 网页搜索概述 -- 所有提供商和自动检测
- DuckDuckGo Search——另一个无密钥提供商
- Brave Search -- 带免费层级的结构化结果
本页有帮助吗?