SearXNG 搜尋

OpenClaw 支援將 SearXNG 作為 自託管、無需金鑰 的 web_search 提供者。SearXNG 是一個開放原始碼的 meta 搜尋引擎，它彙總了來自 Google、Bing、DuckDuckGo 和其他來源的結果。

優點：

免費且無限制 — 不需要 API 金鑰或商業訂閱
隱私 / 隔離網路 — 查詢絕不會離開您的網路
隨處可用 — 商業搜尋 API 沒有區域限制

設定

執行 SearXNG 實例
Terminal window
```
docker run -d -p 8888:8080 searxng/searxng
```
或使用您有權限存取的任何現有 SearXNG 部署。請參閱 SearXNG 文件以了解生產環境設定。

設定

openclaw configure --section web
# Select "searxng" as the provider

或者設定環境變數並讓自動偵測找到它：

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", // optional
            language: "en", // optional
          },
        },
      },
    },
  },
}

baseUrl 欄位也接受 SecretRef 物件。

傳輸規則：

https:// 適用於公開或私有的 SearXNG 主機
http:// 僅接受來自信任的私人網路或 loopback 主機
公開的 SearXNG 主機必須使用 https://
私有/內部主機使用自託管網路守衛；公開 https:// 主機保持嚴格的網頁搜尋守衛，且無法重新導向至私有位址

環境變數

設定 SEARXNG_BASE_URL 作為設定的替代方案：

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

當設定 SEARXNG_BASE_URL 且未設定明確的提供者時，自動偵測會自動選擇 SearXNG（優先順序最低——任何具有金鑰的 API 支援提供者會優先）。

外掛設定參考

欄位	描述
`baseUrl`	您的 SearXNG 實例的基礎 URL（必填）
`categories`	以逗號分隔的類別，例如 `general`、`news` 或 `science`
`language`	結果的語言代碼，例如 `en`、`de` 或 `fr`

注意事項

JSON API — 使用 SearXNG 原生的 format=json 端點，而非 HTML 抓取
圖片結果 URL — 當 SearXNG 傳回直接的圖片 URL 時，圖片類別的結果會包含 img_src
無 API 金鑰 — 可直接與任何 SearXNG 實例搭配使用
基礎 URL 驗證 — baseUrl 必須是有效的 http:// 或 https:// URL；公開主機必須使用 https://
網路守衛 — 私有/內部 SearXNG 端點會選擇加入私有網路存取；公開 https:// SearXNG 端點則保持嚴格的 SSRF 防護
自動偵測順序 — SearXNG 在自動偵測中會最後檢查（順序 200）。具有已設定金鑰的 API 支援提供者會先執行，然後是 DuckDuckGo（順序 100），接著是 Ollama Web Search（順序 110）
自託管 —— 您控制實例、查詢和上游搜尋引擎
類別若未設定，則預設為 general
類別備援 —— 如果非 general 類別的請求成功但返回零結果，OpenClaw 會在返回空結果集前使用 general 重試一次相同的查詢

SearXNG 搜尋

設定

設定

環境變數

外掛設定參考

注意事項

相關