SearXNG 搜尋

OpenClaw 支援將 SearXNG 作為自行託管、 不需金鑰的 web_search 提供者。SearXNG 是一款開放原始碼的中繼搜尋引擎， 可彙整來自 Google、Bing、DuckDuckGo 及其他來源的搜尋結果。

優點：

• 免費且不限用量 -- 不需要 API 金鑰或商業訂閱
• 隱私／網路隔離 -- 查詢絕不會離開您的網路
• 隨處可用 -- 不受商業搜尋 API 的地區限制

設定

openclaw plugins install @openclaw/searxng-plugin

docker run -d -p 8888:8080 searxng/searxng

openclaw configure --section web# 選取 "searxng" 作為提供者

export SEARXNG_BASE_URL="http://localhost:8888"

組態

{  tools: {    web: {      search: {        provider: "searxng",      },    },  },}

SearXNG 執行個體的外掛層級設定：

{  plugins: {    entries: {      searxng: {        config: {          webSearch: {            baseUrl: "http://localhost:8888",            categories: "general,news", // 選用            language: "en", // 選用          },        },      },    },  },}

baseUrl 也接受 SecretRef 物件（例如 { source: "env", id: "SEARXNG_BASE_URL" }）。

環境變數

除了組態之外，也可以設定 SEARXNG_BASE_URL：

export SEARXNG_BASE_URL="http://localhost:8888"

解析順序：已設定的 baseUrl 字串，接著是 baseUrl 上的行內環境變數 SecretRef， 最後是 SEARXNG_BASE_URL。若未設定任何組態路徑、存在 SEARXNG_BASE_URL，且未明確選擇提供者，自動偵測會選用 SearXNG。

外掛組態參考

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
• 網路防護 -- http:// 基底 URL 必須指向受信任的私有或 local loopback 主機（公開主機必須使用 https://）；解析至私有／內部位址的 https:// 基底 URL 享有相同的自行託管允許規則，而解析至公開位址的 https:// 基底 URL 則維持嚴格的 SSRF 防護
• 自動偵測順序 -- SearXNG 需要已設定的 baseUrl（在已具備必要憑證的 提供者中，順序為 200）。DuckDuckGo 或 Ollama Web Search 等不需金鑰的 提供者不會以隱含方式優先於自動偵測；只有明確選擇 provider 時才會啟用
• 自行託管 -- 您可以控制執行個體、查詢及上游搜尋引擎
• 類別在未設定時預設為 general
• 類別備援 -- 如果非 general 類別的請求成功但未傳回任何結果， OpenClaw 會以 general 對相同查詢重試一次，再傳回空白結果集
• 結果快取 -- 相同查詢（查詢內容、數量、類別、語言及基底 URL 均相同） 會在程序內以短暫的 TTL 進行快取
• 版本要求 -- 此外掛宣告 minHostVersion: >=2026.6.9

相關內容

• 網頁搜尋概覽 -- 所有提供者與自動偵測
• DuckDuckGo 搜尋 -- 另一個不需金鑰的提供者
• Brave 搜尋 -- 提供免費方案的結構化結果